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Preface 



The map language and its use in writing 7090/7094 
programs are described in this publication. This sym- 
bolic language encompasses all 7090/7094 machine 
operations, extended machine operations, and special 
operations. In addition, map provides more than sixty 
pseudo-operations, including the powerful macro- 
facility, all of which are described in this publication. 

map language programs are processed by the 7090/ 
7094 assembly program, ibmap, which is a component 
of the 7090/7094 ibjob Processor and which operates 
under the ibjob Monitor. The facilities of iocs, fobtran, 
and cobol are accessible to the map user. 

To assist the user in making the most effective use of 
this flexible programming tool, basic information about 
the map language is provided in Part I of this publica- 
tion. Its main features and capabilities are outlined, and 
the constituents of map symbolic instructions are ex- 
plained. 

The pseudo-operations provided by map have been 
divided into classes according to function. Most of the 
pseudo-operations are described in Part II, where their 
formats are shown and their use in programs is ex- 
plained and demonstrated. 

The macro-facility is described separately in Part III. 



Five appendixes following Part III provide supple- 
mentary information related to the map language. 

It has been assumed that the reader is familiar with 
the contents of one of the following publications: 
IBM 7090 Principles of Operation, Form A22-6528 
IBM 7094 Principles of Operation, Form A22-6703 

The following related publications may also be use- 
ful, depending on individual interests and require- 
ments: 

IBM 7090/7094 IBSYS Operating System: Version 

13, System Monitor (IBSYS), Form C28-6248 
IBM 7090/7094 IBSYS Operating System: Version 

13, IBIOB Processor, Form C28-6389 
IBM 7090/7094 IBSYS Operating System: Version 
13, Input/Output Control System, Form C28-6345 
IBM 7090/7094 IBSYS Operating System: Version 

13, FORTRAN IV Language, Form C28-6390 
IBM 7090/7094 IBSYS Operating System: Version 

13, COBOL Language, Form C28-6391 
Machine requirements for map language programs 
are given in the publication IBM 7090/7094 IBSYS 
Operating System: Version 13, IBJOB Processor, Form 
C28-6389. 
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Part I. Symbolic Programming Using MAP 



Programmers can communicate instructions to com- 
puters at three general language levels. The language 
of the computer itself is the most basic. At the highest 
level are scientific and commercial programming lan- 



: i h a M unn 



Assembly-program languages like the map (Macro 
Assembly Program) language are at the intermediate 
level. 

Because the computer executes instructions at the 
machine-language level, a source program written at 
either of the other two levels must be reduced to a 
machine-language object program before it can be 
executed. Machine-language programming is theo- 
retically the most efficient, since no translation from 
source program to object program is required. For the 
programmer, however, programming in machine lan- 
guage is tedious and time consuming, and program- 
ming errors are more likely. 

A source program written in the Fortran language 
closely resembles the mathematical notation used to 
state a problem to be solved by traditional methods. 
The cobol language is based on English statements 
much like those that would be used to explain a pro- 
cedure. These languages are relatively easy to learn 
and to use because of their similarity to the ordinary 
languages of business and science. 

Source programs written in these languages are 
translated into machine-Ian emacp nrnorams within thp 
computer by a compiler program. By using a compiler, 
the computer can produce an efficient machine- 
language program from a Fortran or cobol source 
program faster and more accurately than a programmer 
can. Such compiler languages thus offer marked advan- 
tages over machine-language programming. However, 
compiler languages are somewhat restrictive. Some 
programming features that are available when using 
machine language cannot be included in any present- 
day compiler. 

An assembly-program language is similar in structure 
to machine language. However, mnemonic symbols are 
substituted for each binary instruction code, and sym- 
bols provided by the programmer are substituted for 
the other fields of an instruction. An assembly-program 
language can also provide additional advantages be- 
yond machine-language programming. For example, 
pseudo-operations can be provided, which often permit 
the coding of one instruction instead of many instruc- 
tions. Thus, an assembly program provides the pro- 
grammer with all the flexibility and versatility of 



machine language but with greatly reduced program- 
ming effort. In addition, error checking can be included 
to facilitate source program debugging. 



7090/7094 MAP Language Features 

Operations 

The 7090/7094 map (Macro Assembly Program) lan- 
guage can be used for all of the 7090/7094 machine 
operations, the extended machine operations, and the 
special machine operations. (All such operations rec- 
ognized by map are listed in Appendix A with supple- 
mentary information about thern. ) In addition, the map 
language provides an extensive set of pseudo-opera- 
tions that supplement machine instructions. 

A pseudo-operation is any operation included in the 
map language that is not an actual machine operation, 
extended machine operation, or special machine opera- 
tion. Pseudo-operations are used by the programmer in 
much the same way as machine operations, map pro- 
vides more than sixty such pseudo-operations to meet 
a variety of programming needs. These pseudo-opera- 
tions, which are described in detail in Parts II and III, 
have been divided into classes according to function. 

Location-Counter Pseudo-Operations enable the pro- 
grammer to establish symbolic location counters and 
control their operation, 

Storage-Allocation Pseudo-Operations reserve areas 
of core storage. 

Data-Generating Pseudo-Operations introduce data 
into a program in any of a variety of formats. They are 
also used in combination to generate tables of data. 

Symbol-Defining Pseudo-Operations are used to as- 
sign specific values to symbols. 

Boolean Pseudo-Operations define symbols as Boolean 
quantities. 

Conditional- Assembly Pseudo-Operations base as- 
sembly of an instruction on programmer established 
criteria. 

Symbol-Qualifying Pseudo-Operations qualify sym- 
bols within sections of a program. 

Control-Section Pseudo-Operations delimit sections 
of a program, facilitating cross-referencing among pro- 
grams and among program segments. 

File-Description Pseudo-Operations define the re- 
quirements of input/output files used by the program. 

Operation-Defining Pseudo^Operations define or re- 
define symbols as operation codes. 
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Miscellaneous Pseudo-Operations indicate the end of 
a program, extend the variable field of an operation, 
and permit remarks to be entered into the assembly list- 
ing. 

Absolute-Assembly Pseudo-Operations specify the 
punched output format of an absolute assembly. 

List-Control Pseudo-Operations specify the contents 
and format of an assembly listing. 

Special Systems Pseudo-Operations generate subrou- 
tine calling sequences. They may also be used to save 
and restore the index registers and indicators. 

Macro-Defining Pseudo-Operations are used to de- 
fine programmer macro-operations. They are used in 
conjunction with the macro-related pseudo-operations, 
which extend the facilities of macro-operations. 

Macro-Operations 

The programmer macro-operation facility is a very 
flexible and powerful programming tool. Many pro- 
gramming applications involve a repetition of a pattern 
of instructions, often with parts of the instructions 
varied at each iteration. Using the macro-defining 
pseudo-operations, a programmer can define the 
pattern as a macro-operation. 

In defining the pattern, the programmer gives it a 
name that becomes the operation code used to gener- 
ate the pattern of instructions. Thus, the coding of a 
single instruction can cause the pattern of instructions 
to be repeated as often as desired. Moreover, parts of 
the instruction can be varied each time the sequence 
is repeated. The contents of any field of any instruction 
within the pattern may be varied, and even entire in- 
structions can be inserted in the sequence. The macro- 
operation facility is described in Part III. 

Location Counters 

During assembly, a location counter registers the next 
location to be assigned to an instruction. For most ma- 
chine instructions processed by the assembly program, 
the contents of the location counter in effect at that 
time (the "current" location counter) is increased by 
1. Some pseudo-operations may result in no increase, 
an increase of 1, or an increase of more than 1. 

map enables a programmer to create and control as 
many symbolic location counters as he needs by using 
the location-counter pseudo-operations. Control can be 
transferred back and forth among them as often as 
desired. 

This feature permits instructions coded in one se- 
quence to be loaded in another, the establishment of 
constant tables, etc. 

Absolute and Relocatable Assemblies 

The control routines of the operating system occupy 
lower core storage. Therefore, a program may not be 



loaded into this area but must be loaded into the first 
unused machine location. However, the programmer 
need not know the address of this location, since the 
loader (ibldr) can automatically relocate each pro- 
gram segment to be loaded. 

The first address of a program segment to be exe- 
cuted is called the load address, and each succeeding 
instruction is loaded relative to that address. Thus, 
the address of an instruction at load time is the address 
assigned to it during assembly plus the load address 
of the program segment in which the instruction ap- 
pears. 

In a relocatable assembly, the assembly program pro- 
duces an object deck that is automatically relocated at 
execution time by ibldr. However, it may sometimes 
be desirable to load a program beginning at a certain 
fixed location in core storage. A program loaded in this 
way is said to have an absolute origin. The programmer 
specifies a certain location as the load address for that 
deck. ( An absolute origin may also be specified within 
a relocatable assembly. See the section "Relocation 
Properties of Symbols.") 

In absolute assemblies, output is in the standard 22- 
word-per-card format, which is specified on the sibmap 
control card and by the abs pseudo-operation. Output 
in this format cannot be handled by ibldr. Whether the 
assembly is absolute or relocatable is specified by the 
programmer on the sibmap card (see the publication 
IBM 7090/7094 IBSYS Operating System: IBJOB Proc- 
essor, Form C28-6389. ) 

Error Checking 

Source programs written in the map language are 
checked for a variety of errors, including format errors, 
table overflow errors, input/output errors, improper 
references, and incorrectly coded operations. In addi- 
tion, the severity of the error is indicated. 

In a normal assembly, messages are printed just after 
the assembly listing. All messages for a given card are 
printed together, and the card groups are printed in 
ascending sequence. Correlation with the listing is ac- 
complished by printing the line number, which is as- 
signed by the assembly program, in the left margin of 
the listing for each card that requires a message. 

A list of map error messages and an explanation of 
the severity code used are included in the publication 
IBM 7090/7094 IBSYS Operating System: IBJOB Proc- 
essor, Form C28-6389. 



Forming Symbolic Instructions 

Instruction Fields 

In the map language, each symbolic instruction is 
punched on a separate standard ibm card. A single 



instruction may have as many as five parts, occupying 
five fields on the card. 

THE NAME FIELD 

An instruction may be given a symbolic name by the 
programmer, so that references may be made in other 
instructions to the named instruction. ( Other methods 
are also available for referring from one instruction to 
another. For example, see the section "Relative Ad- 
dressing." ) 
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some pseudo-operations do require a symbol in the 
name field. Name-field and other requirements of each 
of the pseudo-operations are explained in Parts II and 
III. Also, the specifications for symbols used in the 
name field are given in the section "Symbols." 

The name given to a symbolic instruction is from 1 
to 6 characters long, and it occupies columns 1 through 
6 on the card. 

THE OPERATION FIELD 

The machine operation code, pseudo-operation code, 
programmer macro-operation code, or an operation 
code previously defined by one of the operation- 
defining pseudo-operations appears in the operation 
field. 

The operation field is punched beginning in column 
8. Column 7 separates the name field from the opera- 
tional field. Column 7, which is usually left blank, is 
ignored by the assembly program. 

The character asterisk ( * ) may be used immediately 
to the right of some operation codes to indicate 
indirect addressing. Those machine instructions that 
are indirectly addressable are indicated in Appendix 
A. If indirect addressing is specified for an instruction 
in which it is not permitted, the asterisk ( * ) is ignored 
and a low-severity error message is issued. 

The operation field is usually restricted to a maxi- 
mum of six characters. However, an operation code of 
six characters defined by one of the operation-defining 
pseudo-operations may be followed by an asterisk ( * ) 
to indicate indirect addressing. 

THE VARIABLE FIELD 

The variable field of a symbolic instruction may con- 
tain subfields, separated by commas. 

In machine instructions, these subfields contain the 
address, tag, and/or decrement (or count) parts of 
instruction, depending on the requirements of the 
particular instruction. These parts of the variable field 
are supplied in the order: address, tag, decrement. 

The subfields that are required, optional, or not per- 
mitted in the variable fields of all 7090/7094 machine 
instructions, extended machine operations, and special 
operations are indicated in Appendix A. 



In pseudo-operations, the subfields of the variable 
field may contain symbols, symbolic expressions, and 
literals. The contents of the variable field specified for 
each of the map pseudo-operations is given in Parts II 
and III. 

A null subfield is indicated as being present but as 
having no value. If a null subfield is at the beginning 
of the variable field, it is indicated by a single comma. 
If it is between two other subfields, it is expressed by 
two consecutive commas. A null subfield at the end of 

mo XT-o-rio r»lo fiolH ic ror-\rc»c£>ntorl r>\r a cincrif* r>r»mmQ 

followed by a blank. 

If a subfield that is not used in the variable field ( an 
irrelevant subfield ) is to be followed by a subfield that 
is required ( a relevant subfield ) , the irrelevant subfield 
must be indicated. Irrelevant subfields at the end of 
the variable field may be indicated as null or may be 
omitted entirely. For example, the following pairs of 
instructions are equivalent: 



TXH 
TXH 


fl A 1 

\J,\J,i- 

„1 


IORP 
IORP 


ALPHA,0,1 
ALPHA,, 1 


CLA 
CLA 


ALPHA,0 
ALPHA 


TXH 

TXH 


ALPHA,0,0 
ALPHA,, 


PXA 

PXA 


0,0 



In the last two pairs, the commas may not be omit- 
ted, since the assembly program checks for a minimum 
number of subfields. The txh instruction requires three 
subfields, while the pxa instruction requires two. These 
subfields are not irrelevant and must be included. 

The variable field is separated from the operation 
fioir? \\\7 n¥ looct mna T-»lonV '"><"»!" inn The variable field 
may begin in column 12 but may never begin after 
column 16. The variable field cannot extend beyond 
column 72. An instruction having a variable field ex- 
tending into column 72 may not have a comments field. 
However, the variable field of most instructions may 
be extended over more than one card, each having its 
own comments field, by using the etc pseudo-opera- 
tion. 

THE COMMENTS FIELD 

The comments field is included for the convenience of 
the programmer and does not affect execution of the 
program. This field is generally used for explanatory 
remarks. (See also the section "The Asterisk (*) Re- 
marks Cards.") 

A blank precedes the comments field to separate it 
from the variable field. This field extends through 
column 72 on the card. If there is a blank variable 
field, the comments field may begin as soon as column 
17. An example of the use of the comments field is 
shown in Figure 1. 
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Figure 1. Example of MAP Coding Shows Use of Comments Field 



THE SEQUENCE FIELD 

Symbolic instructions may be numbered for identifica- 
tion in the sequence field, which includes columns 73 
through 80 on the card. 

THE ASTERISK ( * ) REMARKS CARD 

The remarks card is a special source card with an as- 
terisk (*) in column 1 and any desired information in 
the rest of the card. 

Any card with an asterisk in column 1 is treated by 
the assembly program as a remarks card, and its con- 
tents are printed out in the assembly listing. It has no 
other effect on the assembly. 

Remarks cards may be grouped and may appear 
anywhere in a program except in macro-operations or 
between etc cards. They are frequently used at the 
beginning of a program to state the problem to be 
solved, to describe the technique used, etc. (map also 
makes a remarks card available by using the pseudo- 
operation rem, which is described in the section "The 
rem Pseudo-Operation." ) 

Examples of remarks cards are shown in Figure 1, 
as well as methods of coding a variable field. 

Symbols 

The symbolic names used in the name and variable 
fields of symbolic instructions consist of one to six non- 
blank bcd characters (see Appendix E). At least one 
nonnumeric character must be included, but none of 
the following ten characters may be used: 

+ (plus sign) = (equal sign) 

— ( minus sign ) , ( comma ) 

* (asterisk) ' (apostrophe) 

/ ( slash ) ( ( left parenthesis ) 

$ ( dollar sign ) ) ( right parenthesis ) 

Parentheses in a symbol cause a low-severity warn- 
ing message to be printed, but assembly is not affected. 
However, the ()ok option specified on the sibmap 



control card (see the publication IBM 7090/7094 
IBSYS Operating System: IB JOB Processor, Form: 
C28-6389) indicates that parentheses in symbols are 
desired, and no message will be printed. 
Examples of valid symbols are: 

A 3.2XY 

37B2_ DECLOC 

DELTA 

Conversely, the following are not valid symbols for 
the reasons indicated: 

A + B ( invalid character ) 

3921 ( no nonnumeric characters ) 

A2B4C6D ( more than six characters ) 

Defining Symbols 

When a symbol has been assigned a value, it is said 
to be defined. The assigned value can be the address 
of a location within core storage, an arbitrary quantity 
specified by the programmer, or a dependent value 
assigned by the assembly program. Values are assigned 
to symbols during and after the first of the two passes 
made by the assembly program over the source pro- 
gram. Further information about the assembly pro- 
gram is provided in the publication IBM 7090/7094 
IBSYS Operating System: IBJOB Processor. Form 
C28-6389. 

Ordinary Symbols 

Several types of symbols are used in the variable fields 
of machine instructions and in most of the pseudo- 
operations. 

1. Location symbols are so called because of their 
appearance in the name field of an instruction. During 
the first pass of the assembly program, location sym- 
bols in the variable field of an instruction are immedi- 
ately assigned a value called an S-value. The S-value 
is 1 if the symbol has previously appeared in the name 
field of an instruction and if it has not. After the first 
pass has been completed, these symbols are assigned 
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the value of the address of the instruction in which 
they appeared as a name-field symbol. 

Absolute symbols are location symbols having fixed 
values that are independent of any relocation of the 
program segment. 

2. Virtual symbols are used in the variable field of 
an instruction and never appear in any name field. 
Virtual symbols, which have special functions in map, 
are defined at load time. The S-value is 0. ( For further 
information, see the publication IBM 7090/7094 IBSYS 
Operating System: IBJOB Processor, Form C28-6389. ) 
Virtual symbols are permitted only in a relocatable 
assembly. In an absolute assembly, virtual symbols are 
flagged as undefined. 

3. System symbols from the ibsys, ioex and ibjob 
communication regions are predefined by the assem- 
bler if a System Symbol Option ( monsym or jobsym ) 
appears on the sibmap control card. If symbols thus 
defined are used in the variable field of an instruction 
in the source ^ro^ram the^ will be treated as absolute 
symbols appearing in the qualification section "S.S." 
The S-value is 1. ( For further information concerning 
the use of the System Symbol options, and the symbols 
involved, see the publication, IBM 7090/7094 IBSYS 
Operating System: IBJOB Processor, Form C28-6389. ) 

Immediate Symbols 

Immediate symbols are created by using them in the 
name field of the set pseudo-operation. Immediate 
symbols are assigned a value (S-value) during the first 
pass of the assembly program. Immediate symbols may 
also be redefined throughout a program by using ad- 
ditional set pseudo-operations. (See the section "The 
„„„ -n ]~ r\ t.: — "\ tu„ C„l ,, n l„^ ^C nn ; mmQ _ 
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diate symbol is used in evaluating variable fields of 
pseudo-operations affecting location counters. 

Relocation Properties of Symbols 

An absolute origin may be specified in a relocatable as- 
sembly, which should not be confused with an absolute 
assembly. If an absolute origin is given in a relocatable 
assembly, any symbols whose definitions depend on 
that origin are absolute. However, instructions under 
the absolute origin may refer to symbols elsewhere in 
the program. The assembly can be returned to the re- 
locatable mode by subsequently specifying a relocat- 
able origin. 

Under the following conditions, symbols are abso- 
lute even if they appear within a relocatable assembly: 

1. Symbols whose values depend on an absolute 
origin (as a result of using the org or begin pseudo- 
operations ) . 

2. Symbols defined by the bool, rbool, and lbool 
pseudo-operations. 



3. Symbols defined by the equ or syn pseudo-opera- 
tions and whose values reduce to a constant. 

4. Symbols defined by a max or min pseudo-opera- 
tion that yield a constant. 

5. Symbols used in the variable field of type D in- 
structions. 

6. Symbols defined by the set pseudo-operation. 

Literals 

Literals provide a simple means for introducing data 
words and constants into a program. For example, if a 
programmer wishes to add the number 1 to the con- 
tents of the accumulator, he must have the number 1 at 
some location in storage. 

In contrast to other types of subfields, the contents of 
a literal subfield is itself the data to be operated on. 
The appearance of a literal directs the assembly pro- 
gram to prepare a constant equal in value to the con- 
tent of the literal subfield. The assembly program 
replaces the subfield of the variable field of the in- 
struction containing the literal with the address of the 
constant thus generated. 

All the literals used in a program are placed in the 
Literal Pool. Unless the programmer specifies another 
location (see "Literal-Positioning Pseudo-Operations"), 
the Literal Pool begins one location beyond the final 
value of the location counter in use at the end of 
the program. 

There are three types of literals — decimal, octal, and 
alphameric. 

decimal literals 

A decimal literal consists of the character = followed 
by a decimal data item. Three types of decimal data 
items are recognized by map: 

Decimal Integers. A decimal integer is one or more 
of the digits through 9, and it may be preceded by a 
plus or minus sign. Maximum size of the decimal in- 
teger is 2 35 — 1. 

Floating-Point Numbers. A floating-point number 
has two components. 

1. The principal part is a signed or unsigned decimal 
number, which may be written with or without a deci- 
mal point. The decimal point may appear at the be- 
ginning, at the end, or within the decimal number. If 
an exponent part is present, the decimal point may be 
omitted, in which case it is assumed to be at the right 
end of the decimal number. The principal part cannot 
exceed twenty digits. If it does, the number will be 
truncated and only the first twenty digits will be used. 

2. The exponent part consists of the letters e or ee 
followed by a signed or unsigned decimal integer. 
(The letters ee indicate a double-precision floating- 
point number. ) The exponent part may be omitted. If 
the exponent part is used, it must follow the principal 
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part. The exponent part cannot exceed two digits. If it 
does, it will be truncated and only the first two digits 
will be used. 

A floating-point number is converted to a normalized 
floating-point binary word. The exponent part, if pres- 
ent, specifies a power of ten, by which the principal 
part is multiplied during conversion. For example, all 
of the following floating-point numbers are equivalent 
and are converted to the same floating-point binary 
number. 

3.14159 

31.4159E-1 

314159.E-5 

314159E-5 

.314159E1 

The octal representation of this number is 
202622077174 

Similarly, the number .314159EE1 is converted to a 
double-precision floating-point number. Its octal repre- 
sentation is 

202622077174 
147015606335 

Fixed-Point Numbers. A fixed-point number has 
three components. 

jl. me pi iiHsijjui yun is a. aigiicu. ui uiiMgneu uecuiicu 

number, which may be written with or without a deci- 
mal point. The decimal point may appear at the begin- 
ning, at the end, or within the decimal number. If the 
decimal point is omitted, it is assumed to be at the 
right end of the decimal number. The principal part 
cannot exceed twenty digits. If it does, the number will 
be truncated and only the first twenty digits will be 
used. 

2. The exponent part consists of the letters e or ee 
followed by a signed or unsigned decimal integer. 
( The letters ee indicate a double-precision fixed-point 
number.) The exponent part may be omitted. If the 
exponent part is used, it must follow the principal part. 
The exponent part cannot exceed two digits. If it does, 
it will be truncated and only the first two digits will 
be used. 

3. The binary-place part consists of the letters b or 
bb followed by a signed or unsigned decimal integer. 
(The letters bb indicate a double-precision fixed-point 
number.) The binary-place part must be present in a 
fixed-point number and must come after the principal 
part. If the number has an exponent part, the binary- 
place part may either precede or follow the exponent 
part. The binary-place part may not exceed two digits. 
If it does, the number will be truncated and only the 
first two digits will be used. 

A fixed-point number is converted to a fixed-point 
binary number that contains an understood binary 
point. The binary-place part specifies the location of 
this understood binary point within the word. The 



number that follows the letters b or bb specifies the 
number of binary places in the word at the left of the 
binary point. The sign bit is not counted. Thus, a 
binary-place part of zero specifies a 35-bit binary frac- 
tion. B2 specifies two integral places and 33 fractional 
places, B35 specifies a binary integer, b-2 specifies a 
binary point located two places to the left of the 
leftmost bit of the word; that is, the word would con- 
tain the low-order 35 bits of a 37-bit binary fraction. As 
with floating-point numbers, the exponent part, if pres- 
ent, specifies a power of ten, by which the principal 
part will be multiplied during conversion. 

For example, the following fixed-point numbers all 
specify the same bit configuration, but not all of them 
specify the same location for the understood binary 
point: 

22.5B5 
11.25B4 
1125E-2B4 
9B7E1 

All of the above fixed-point numbers are converted 
to the binary configuration having the octal repre- 
sentation 

264000000000 

Trie following double-precision fixed-point numbers 

10BB35 
1B35EE1 
1BB35E1 
1BB35EE1 

are converted to the binary configuration having the 
octal representation 

000000000012 
000000000000 

Double-precision literals are stored in consecutive 
locations. The first or high-order part is automatically 
stored in an even location relative to the beginning of 
the Literal Pool. If these literals are to be used as oper- 
ands in double-precision operations (7094), an even 
pseudo-operation must be inserted immediately before 
the lorg pseudo-operation if there is one; otherwise it 
must be inserted before the end pseudo-operation. 

OCTAL LITERALS 

An octal literal consists of the two characters =0 
followed by an octal integer. 

An octal integer is a string of not more than twelve 
of the digits through 7, and it may be preceded by a 
plus or minus sign. 

Examples of octal literals are: 



=0123 
= + 123 
= 0-123 



000000000123 
000000000123 
400000000123 



ALPHAMERIC LITERALS 

An alphameric literal consists of the two characters 
= H followed by exactly six alphameric characters. 
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The six characters following the H are treated as data 
even if one or more of thern is a comma or a blank. 
Examples of alphameric literals are: 

=H12ABCD 

= HTADbbb, where b represents a blank 

Writing Expressions 

The programmer writes expressions to represent the 
subfields of the variable field of symbolic instructions. 
Expressions are also used in the variable fields of many 

~£ il ~„„,,.rl,-» nnn .nh'nnc ir-> n/i/inrrloTino MI7ltb tb*> rillp*! 
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set forth for each specific case. 

Expressions are comprised of elements, terms, and 
operators. 

ELEMENTS 

An element is the smallest component of an expression 

and is either a single symbol or a single integer less 

than 2 15 . The asterisk ( *) may be used as an element 

representing the location of the instruction in which it 

appears. 

Examples of valid elements are: 

A 

427 

ALPHA 

TERMS 

A term is a group of one or more elements and the 
operators * (indicating multiplication) and / (indi- 
cating division). 

A term consists of one or more elements, with each 
element separated by an operator. A term must begin 
and end with an element. Two operators or two ele- 
ments in succession are never permissible. 

T7-. 1 r ,.„1:J 4- — ~,„ „~^. 

.CiXcUlipiCo ui vaijua lcij.ho axe 

A A*B 

427 C/1409 

ALPHA BETA*GAMMA/DELTA 

There is no ambiguity between using the asterisk 

as an element and its use to denote multiplication, since 

position always makes clear its intended function. For 

example, a field coded 

would be interpreted as "the location of this instruction 
multiplied by B." Since a term must begin with an 
element, the first asterisk must be an element. The 
second asterisk must be an operator, which is required 
between two elements. 

EXPRESSIONS 

An expression is a group composed of one or more 
terms and the operators + (signifying addition) and 
— ( signifying subtraction ) . 

An expression consists of one or more terms, with 
each term separated by a plus or minus sign. Two op- 
erators or two terms in succession are never permiss- 



ible. However, an expression may begin with a plus 
or minus sign. Examples of valid expressions are: 

A 

ALPHA 

ALPHA*BETA 

-A/B 

A*B-C/D+E*2303 

*-A+B*C 

The asterisk in the last example is used first as an 

element and then as an operator. 

Evaluating Expressions 

In evaluating expressions, elements are evaluated first, 
then individual terms, and finally the complete expres- 
sion. The following procedure is used in evaluating 
expressions: 

1. Each element is replaced with its numeric value. 

2. Each term is evaluated by performing the indi- 
cated multiplications and divisions from left to right. 
In division, the integral part of the quotient is retained 
and any remainder is discarded immediately. For ex- 
ample, the value of the term 5/2*2 is 4. 

In evaluating a term, division by zero is the same as 
division by one and results in the original dividend. 
Division by zero is not regarded as an error. 

3. Terms are combined from left to right in the order 
in which they occur, with all intermediate results re- 
tained as 35-bit signed numbers. 

4. Finally, if the result is negative, it is comple- 
mented; in either case, the rightmost 20 bits are re- 
tained if the expression is a subfield of a vfd pseudo- 
operation. Otherwise, only the rightmost 15 bits are 
retained. 

Grouping of terms by parentheses or any other 
means is not permitted. However, a product such as 
A(B-c) can be written simply a*b-a*c. 

The expression ** may be used to designate a field 
the value of which is to be computed and inserted by 
the program. It is an absolute expression having a value 
of zero. 

Rules for Forming Expressions 

The use of expressions is sometimes affected by whether 
elements within the expression are relocatable, abso- 
lute, or a combination of both. 

In a relocatable assembly, an expression that con- 
tains more than one symbol is generally complex. An 
expression that includes a control-section name is also 
complex. In addition, any expression that contains a 
complex element is itself complex. 

In an absolute assembly, all expressions are absolute. 

Relocatable and complex expressions are usually 
evaluated at load time, when absolute values have 
been assigned to symbols as part of the loading process. 
However, in pseudo-operations that affect location 
counters (such as bes, bss, and begin) or that define 
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symbols (such as max and min), the variable field 
must be evaluated before load time. For further in- 
formation, see the publication IBM 7090/7094 IBSYS 
Operating System: IBJOB Processor, Form C28-6389. 
The rules that must be followed in using expressions 
are provided in the discussions of the pseudo- 
operations. 

Boolean Expressions 

A Boolean expression is evaluated as an 18-bit Boolean 
quantity, unlike the 15-bit integer that normally results 
from the evaluation of an expression. Elements within 
a Boolean expression must be constant. All integers are 
specified as octal integers. An expression is Boolean if: 

1. It appears in the variable field of a Boolean 
pseudo-operation (bool, rbool, lbool; see the section 
"Boolean Pseudo-Operations" ) ; 

2. It appears as an octal subfield of a vfd pseudo- 
operation (see the section "The vfd Pseudo-Opera- 
tion" ) ; or 

3. It forms the variable field of a Type D or extended 
Type D machine instruction ( see Appendix A ) . 

Relocatable symbols in a Boolean expression are 
evaluated as 15-bit integers and virtual symbols are 
evaluated as zero. In either case, an error message is 
issued. 

In a Boolean expression, the four operators ( + , — , 
*, /) have Boolean rather than arithmetic meanings, 
as shown in the table. 



5RATOR 


MEANING 




DEFINITION 


+ 


"inclusive or" 


( also, 


0+0=0 




"union" ) 




0+1 = 1 
1 + 0=1 
1 + 1 = 1 


- 


"exclusive or" 


( also, 


0-0=0 




"symmetric differ- 


0-1 = 1 




ence" ) 




1-0=1 
1-1=0 


* 


"and" ( also, 


"inter- 


0*0=0 




section" ) 




0*1=0 
1*0=0 
1*1 = 1 


/ 


"complement" 


(also, 


/0=1 




"not" or "ones' 


com- 


/1 = 




plement" ) 







The four Boolean operations are defined in the table 
for 1-bit quantities. The operation is extended to 18-bit 
quantities by handling each bit position independently. 

The following conventions also apply in using Bool- 
ean expressions: 

The / is a unary or one-term operator. The expres- 
sion a/b means /b, and the a is ignored. However, the 
presence of the a is not regarded as an error by the 
assembly program. The definitions of / in this case are: 

0/0=1 
0/1=0 
1/0 = 1 
1/1=0 



If the other operators ( + , — , * ) are used as unary 
operators, the definitions are as follows: 

+A=A+=A 

-A = 0-A,A-=A-0 

*A = error, A* = A*0 = 

For the special case of the slash, the definition is : 

A/=A/0 = 1 

In expressions where both terms are missing, defini- 
tions are as follows: 

+ =0+0=000000 
-=0-0=000000 
* = Location counter 

/ = 0/0 = 777777 

In evaluating a Boolean expression, all integers are 
treated as 18-bit quantities. The operation / is per- 
formed first, followed by *, then by + and — . 

The operators +, — , and * may immediately pre- 
cede the slash in a Boolean expression. For example, 

A-/B 
is a valid Boolean expression. However, in no other 
case are two operators or two elements in succession 
permitted. 

Using Symbols in Expressions 

xn MAP, ordinary symuols are not assigned values until 
a pass over the entire program has been completed. 
Therefore, there are no restrictions in the order of 
symbol definition. For example, 

ORG A 

A EQU 10000 

is a valid sequence in ibmap. 

Symbols in the variable field of pseudo-operations 
that affect location counters must be definable at as- 
sembly time. In the sequence 



BEGIN 


,A 


BSS 


B 


BES 


C 



A, B, and C may not be virtual symbols. (The org 
pseudo-operation is not subject to this restriction. ) The 
values of symbols B and C are always treated as 
constant. 

In general, any valid expression may appear in the 
variable field of machine instructions. In a relocatable 
assembly, final evaluation of complex arithmetic ex- 
pressions containing virtual symbols actually takes 
place at load time, when all symbols have been defined. 

Relative Addressing 

After an instruction has been named by the presence 
of a symbol in the name field, references to that in- 
struction can be made in other instructions by using 
the symbol. Instructions preceding or following the 
named instruction can also be referenced by indicating 
their position relative to the named instruction. This 
procedure is called relative addressing. A relative 
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address is, effectively, a type of expression. For exam- 
ple, in the sequence 



ALPHA 



STGAM 



TRA 
CLA 
SUB 
STO 
TPL 



BETA 

GAMMA 

DELTA 

GAMMA 

LOCI 



control may be transferred to the instruction cla 
gamma by either of the following instructions: 



TRA 
TRA 



ALPHA +1 
STGAM -2 



iv ;j isi i 
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ment in a relative address. For example, in the 
sequence 

LOOP 



AXT 


10,1 


CLA 


A,l 


SUB 


B,l 


SUB 


C,l 


STO 


SUM,1 


TIX 


LOOP,l,l 



the last instruction indicates a conditional transfer to 
location loop. Ini 



TIX 



'-4,1,1 



The address * — 4 is interpreted as "the location of 
this instruction minus 4." 

Relative addressing must be used carefully in com- 
bination with pseudo-operations, since some pseudo- 
operations may generate more than one word or no 
words in the object program. For example, the in- 
struction 



ALPHA 



OCT 



2732,427,12716 



generates three words of octal data, with alpha as- 
signed to the address of the first word generated. Thus 
the address alpha +2 refers to the third word gener- 
ated (12716). 

Reference can also be made to a word in a block of 
storage reserved by a bss or bes pseudo-operation by 
using relative addressing. For example, the instruction 

BETA BSS 50 

reserves a block of 50 words, where beta is assigned 
to the first word of the block. The address beta+ i refers 

4-„ 4.1, „ „„„„-, J ...„-J „~J ^^.r., . , ~* -£,£„ 4-„ 4-l a f^> _L 7^4- 

LU Uld 5CUUUU wuiu, CUIV-I jjjiiath lCicii lu ific (ht j. yau 

word. 
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Part II. MAP Pseudo-Operations 



map provides the programmer with more than sixty 
pseudo-operations that can perform a variety of pro- 
gramming functions with greatly reduced program- 
ming effort. They have been grouped according to 
function, and the structure and purpose of most of the 
map pseudo-operations are described in this part of the 
publication. The macro-operation facility is covered 
separately in Part III. 



Location-Counter Pseudo-Operations 

Location counters enable instructions that are written 
in one sequence to be loaded in a different sequence. 
map enables a programmer to establish an indefinite 
number of location counters, which can be repre- 
sented by symbols of his choice. The symbol used to 
represent a location counter may duplicate any other 
symbol in the program except another location-counter 
symbol. 

The blank location counter, so called because it has 
no associated symbol, is the basic location counter. If 
the use pseudo-operation is not used, instructions are 
assembled under the blank location counter. In addi- 
tion, a location counter represented by two slashes 
( // ) is reserved for use with blank common. 

The USE Pseudo-Operation 

The use pseudo-operation places succeeding instruc- 
tions under control of the location counter represented 
by the symbol in the variable field. The format of the 
use pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


USE 


Either: 

1. A single symbol, or 

2. Blanks, or 

3. //, or 

4. The word PREVIOUS 



The location counter in control at the time of the 
use pseudo-operation is suspended at its current value. 
It is temporarily preserved as the "previous" counter. 
It continues from this value if it is reactivated by 
another use. If use with the word previous in the vari- 
able field is coded, the previous location counter is 
reactivated. For example, the effect of the sequence 



is identical to that of 

USE A 

USE B 

USE A 

This option provides a means of returning to a 
location counter even if the counter symbol is not 
known. 

A use pseudo-operation with a blank variable field 
must precede the first instruction of the deck if the 
blank counter is set to a value other than zero by the 
operation 

BEGIN expression 

The sequence of location counters is: the blank 
counter first, the other symbolic counters in the order 
of their first appearance in a use or begin pseudo- 
operation, and finally the // counter. 

The BEGIN Pseudo-Operation 

Hru~ ~~ — xt 1~ ^ „*.; — ,-C~„ „ 1~„„*;^. „„„*-„*. 
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and establishes its initial value. The format of the 
begin pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


BEGIN 


Two subfields, separated by 
a comma: 

1. A location counter symbol, 

2. Any expression 



USE 


A 


USE 


B 


USE 


PBEVIOUS 



The expression in the variable field may contain any 
symbol or constant. Relocatable symbols are given 
their assembly value, and this value becomes absolute. 
Control-section symbols are given a value of zero. 

The value of the second subfield of the variable field 
is used as the initial value for the location counter 
represented by the symbol in the first subfield. For 
example, the instruction 

BEGIN ALPHA,BETA 
would cause the instructions following 

USE ALPHA 

to be assembled beginning at location beta. 

If no begin is given for the blank location counter, its 
initial value is defined as ( absolute in an absolute 
assembly and relative in a relocatable assembly ) . If 
no begin is given for the nth location counter ( taken in 
location counter order ) , its initial value is given as the 
last value by the (n-I)st location counter. If more 
than one begin is given for a specific location counter, 
only the first one is used. Each of the others causes an 
error message to be issued and is printed as a com- 
ment, but is otherwise ignored. 



14 



A begin may appear anywhere in the program re- 
gardless of the location counter in control. 

Note that if the blank location counter is set to a 
value other than zero by the operation 

BEGIN expression 

the use pseudo-operation with a blank variable field 
must precede the first instruction of the deck. 

The order in which location counters are used is 
illustrated in the example: 

instruction 1 



For example, the location counter is set at the sixth 
location of the program by 



KH I -I i\l 



USE A 

instruction 2 

instruction 3 

BEGIN C* 

instruction 4 

instruction 5 

USE // 

instruction 6 

instruction 7 

USE B 

instruction 8 

instruction 9 

USE C 

instruction 10 

END 
In this sequence, instruction counters are used in the 
order: blank, A, C, B, and //. At load time, the se- 
quence of instructions will be: 

instruction 1 
instruction 2 
instruction 3 
instruction 10 (instruction 4 will be 

overlaid ) 
instruction 8 (instruction 5 will be 

overlaid ) 
instruction 9 
instruction 6 
instruction 7 



The ORG Pseudo-Operation 

The org ( Origin ) pseudo-operation redefines the value 
of the current location counter. The format of the org 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1, A symbol, or 

2. Blanks 


ORG 


Any expression 



The org pseudo-operation causes the current location 
counter to be reset to the value of the variable field. If 
there is a symbol in the name field, it is given this value. 

Absolute origins are permitted in a relocatable as- 
sembly. An origin is treated as absolute if the value of 
the variable field of the org pseudo-operation is con- 
stant. Thus, 

ORG 5000 

sets the location counter to 5000. In a relocatable as- 
sembly, references to symbols under the control of an 
absolute origin ( org or begin ^ are absolute. 



ORG 



START +5 



where start is the first location of the program. 

An org terminates the effect of a loc pseudo-opera- 
tion by redefining the value of the current location 
counter and ensuring that this value is used as the 
next binary card origin. 

The LOC Pseudo-Operation 

The loc pseudo-operation permits symbolic address- 
ing in segments of an object program that are to be 
loaded at one area of storage and then moved to, and 
executed from, another. It redefines the value of the 
current location counter but does not affect the load 
address. 

The format of the log pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


LOC 


Any expression 



The current location counter is reset to the value 
specified in the variable field. If there is a symbol in 
the name field, it is given this value. 

However, binary card origins are not affected by 
the loc pseudo-operation. They remain relative to the 
value of the location counter prior to the log, indi- 
cating the address at which the program segment is 
to be loaded. 

If another loc is encountered when one is already 
in effect, the current location counter is set to the 
value specified in the new loc. 

The loc pseudo-operation may be used only if an 
absolute assembly (absmod) is specified on the sibmap 
control card. (See the publication IBM 7090/7094 
IBSYS Operating System: IBJOB Processor, Form 
C28-6389, for a discussion of the sibmap control card. ) 

The effect of a loc pseudo-operation must be termi- 
nated (see "The org Pseudo-Operation.") before a use 
pseudo-operation appears. Otherwise, the loc will be 
terminated automatically and an error message issued 
because undesirable location counter values may 
result. 



Storage-Allocation Pseudo-Operations 

The storage-allocation pseudo-operations reserve core 
storage areas within the sequence of the program. 

The BSS Pseudo-Operation 

The bss (Block Started by Symbol) pseudo-operation 
reserves a block of consecutive storage locations and 
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may describe the data that will occupy the block. The 
format of the bss pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


BSS 


One or two subfields, 
separated by a comma: 

1. Any expression, 

2. Modal and dimensional 
information 



The bss pseudo-operation increases the value of the 
current location counter by the defined value of the 
expression in the first subfield of the variable field. 
The expression may contain any symbol or constant. 
Relocatable symbols are given their assembly value, 
and this value becomes absolute. Control-section sym- 
bols are given a value of zero. If there is a symbol in 
the name field, its defined value is that of the location 
counter just before the increase. 

When the second subfield is used, a symbol must 
appear in the name field. This subfield supplies modal 
and dimensional information to the debugging dic- 
tionary about the data that will occupy the block. The 
second subfield must be used if the symbol in the 
name field also appears in the variable field of a keep 
pseudo-operation or if the full debugging dictionary 
is specified in the variable field of a sibmap card. ( See 
the publications IBM 7090/7094 IBSYS Operating 
System: IBJOB Processor Debugging Package, Form 
C28-6393 and IBM 7090/7094 IBSYS Operating Sys- 
tem: IBJOB Processor, Form C28-6389.) The format 
for this subfield is : 

mode (d l5 d 2 , d 3 ) 
where di, d 2 , and d 3 are the dimensions, if any, of the 
array denoted by the symbol in the name field, and 
mode is one of the following: 

O Octal 

F Floating-point number 

X Fixed-point number 

D Double-precision floating-point number 

J Complex number 

L Logical 

S Symbolic instruction 
C Symbolic command 
H Alphameric 

If an entry for mode is not one of the nine recognized 
letters above, the mode is assumed to be octal. If an 
entry for dimension is not a decimal integer, an error 
message is issued. 

When the second subfield is not used, it is assumed 
that the mode is octal and the dimension is 1. 

For example, in the sequence 

ALPHA IORT BETA„4 

BETA BSS 4 

GAMMA IORT DELTA„6 

if alpha has been assigned to location 1001, beta 
will be assigned to location 1002 and gamma to loca- 



tion 1006. Thus, four locations are reserved for an 
array whose first element is at location beta; and an 
entry, specifying that this array is one-dimensional 
and that its elements are octal numbers, is made into 
the debugging dictionary. 

In addition to reserving four locations, the instruc- 
tion 

BETA BSS 4,F(2,2) 

indicates to the debugging dictionary that the data to 
occupy this area is a 2 by 2 array of floating-point 
numbers. 

The area reserved by the bss pseudo-operation is 
not zeroed. 

The BES Pseudo-Operation 

The bes (Block Ended by Symbol) pseudo-operation 
also reserves a block of consecutive storage locations 
and may describe the data that will occupy the block. 
The format of the bes pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


BES 


One or two subfields, 
separated by a comma: 

1. Any expression, 

2. Modal information 



The expression in the first subfield of the variable 
field may contain any symbol or constant. Relocatable 
symbols are given their assembly value, and this value 
becomes absolute. Control-section symbols are given 
a value of zero. 

The bes pseudo-operation functions almost identi- 
cally to a bss pseudo-operation except that the symbol 
in the name field is defined after the location counter 
increases and thus refers to the first word following 
the reserved block. 

A symbol must appear in the name field of a bes 
pseudo-operation if the second subfield of the vari- 
able field is used. This subfield has the same use as it 
does in the bss except that it specifies modal informa- 
tion only. (If dimensional information is given, it is 
ignored. ) Thus an entry in the second subfield of the 
variable field of a bes instruction consists of one of the 
letters o, f, x, d, j, l, s, c, or h, as described in the 
discussion of the bss pseudo-operation. If the entry for 
mode is omitted or is a symbol other than the nine 
listed above, the mode is assumed to be octal. 

For example, in the sequence 

ALPHA IORT BETA„4 

BETA BES 4 

GAMMA IORT DELTA„4 

if alpha has been assigned to location 1001, both beta 
and gamma will be assigned to location 1006 and four 
locations will be reserved for octal data. 

In addition to reserving four locations, the instruc- 
tion 
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BETA BES 4,X 

supplies the debugging dictionary with the informa- 
tion that the data to occupy this area is in the fixed- 
point mode. 

The difference between bes and bss can be seen in 
the sequence of instructions 



ALPHA 



BES 
CLA 



25 
BETA 



which is effectively the same as 



BSS 25 

CIT.A RT^.TA 



The area reserved by the bes pseudo-operation is not 
zeroed. 

The EVEN Pseudo-Operation ?&'"/& - ICjH ^"'■if^' 
The even pseudo-operation forces the current location 
counter to an even value to ensure an even address for 
the next instruction or data— usually a double-precision 
floating-point number. It is used only in the 7094 and 
has no effect in the 7090 or 7094 n. The format of the 
even pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


EVEN 


Ignored 



In a 7094 relocatable assembly, the even pseudo- 
operation causes the instruction 

AXT 0,0 

to be inserted at load time if the load address of the 
axt instruction is not even. The axt instruction has no 
other effect on the program. 

In a 7094 absolute assembly, the even pseudo- 
operation causes the insertion of the instruction 

AXT 0,0 

at assembly time so that it is available at load time in 
the event that the axt instruction load address is not 
even. The axt instruction has no other effect on the 
program. 

The LDIR Pseudo-Operation 

The ldir ( Linkage Director ) pseudo-operation places 
the Linkage Director in the program at the point of 
the ldir. The format of the ldir pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1 4 e,.,,,!-.,,! 

jl. ii. oy iiluui, ui 

2. Blanks 


T TATTJ 
JL-iJ-Viri 


Ignored 



The Linkage Director is a unique location for each 
assembly, which is one beyond the final value of the 
location counter if the ldir pseudo-operation is not 
used. If the ldir pseudo-operation is used with a sym- 
bol in the name field, the programmer may refer to the 



The Linkage Director serves as a cross-reference for 
the call and save pseudo-operations. If neither the 
ldir nor lorg pseudo-operations is used, the Linkage 
Director precedes the Literal Pool. If the ldir pseudo- 
operation appears more than once, only its first appear- 
ance is effective. 

For example, 

ALPHA LDIR 

would cause 

ALPHA dvt? 

BCI l,deckname 

to be generated. The second subfield in the bci opera- 
tion is the deckname specified on the sibmap card ( see 
the publication IBM 7090/7094 IBSYS Operating Sys- 
tem: IB JOB Processor, Form C28-6389). 

The COMMON Pseudo-Operation 

The common pseudo-operation has been preserved 
solely for compatibility with existing programs. When 
used together with the pseudo-operation 

CONTRL // 
it reserves a storage area called blank common for use 
with such programs. The format of the common 
pseudo-operation is: 





OPERATION 




NAME FIELD 


FIELD 


VARIABLE FIELD 


1. A symbol, or 


COMMON 


One or two subfields separated 


2. Blanks 




by a comma: 

1. Any expression 

2. Modal and dimensional in- 
formation 



The first subfield of the variable field may contain 
any symbol or constant. Relocatable symbols are given 
their assembly value, and this value becomes absolute. 
Control-section symbols are given a value of zero. 

The common operation causes : 

1. Location counter // to be activated 

2. A symbol in the name field, if any, to be defined 
as having the current value of location counter // 

3. Location counter // to be increased by the defined 
value of the variable field expression 

4. The location counter in use prior to the common 
operation to be reactivated 

The effect of the sequence 

A COMMON E 

is equivalent to 



USE 


// 


BSS 


E 


USE 


PREVIOUS 



T ; n l 



nkage Director. 



-t-ixjLiivci 



The second subfield of the variable field is used in the 
same way as the second subfield of the bss pseudo- 
operation. (See "bss Pseudo-Operation.") 
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Literal-Positioning Pseudo-Operations 

Two pseudo-operations, lorg and litorg, enable the 
programmer to determine the origin of the Literal 
Pool (see "Literals"). 

If neither of these pseudo-operations is used, the 
Literal Pool begins one location beyond the final value 
of the location counter in use at the end of a program. 
If more than one location counter is used by a pro- 
gram, the Literal Pool might overlay part of the pro- 
gram. For example, in the sequence 





USE 


Y 


A 


BSS 


1 




USE 


X 


B 


CLA 


= 1 




USE 


Y 




END 





the Literal Pool would begin at symbolic location B 
(one beyond the final value of location counter Y). 
Overlay also occurs if the // location counter is used 
but is not in effect at the end of the program. Specify- 
ing ,the location of the Literal Pool with a lorg or a 
litorg can eliminate this overlapping. 

If double-precision literals are used in a 7094 pro- 
gram, an even pseudo-operation should precede a lorg 
or litorg to ensure their entry at an even numbered 
address. 

The LORG Pseudo-Operation 

The lorg ( Literal Pool Origin) pseudo-operation con- 
trols the positioning of all literals used in a program 
that are not under control of a litorg pseudo-oper- 
ation. The format of the lorg pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


LORG 


Ignored 



As a result of this pseudo-operation, the Literal Pool 
starts at the location of the lorg in the symbolic deck. 
This location is assigned the value of the symbol in 
the name field. For example, the sequence 





USE 


Y 


A 


BSS 


1 




USE 


X 


B 


CLA 


= 1 




USE 


Y 


C 


LORG 
END 





would place the beginning of the literal pool one be- 
yond symbolic location B and give it the symbolic 
name C. 

If more than one lorg is given, only the first is effec- 
tive. Duplicate literals under the control of a lorg 
are eliminated. 



The LITORG Pseudo-Operation 

The litorg ( Literal Origin ) pseudo-operation enables 
literals used within a block of coding to be associated 
with that block. The primary use of this pseudo-oper- 
ation is to associate the literals used within a control 
section (see "Control Dictionary Pseudo-Operations") 
with that control section. 

The format of the litorg pseudo-operation is : 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


LITORG 


Ignored 



All literals encountered prior to a litorg pseudo- 
operation (either from the beginning of the program 
or from a previous litorg) are placed in a pool start- 
ing at the location of the litorg. The beginning of 
the pool is assigned the symbol in the name field. For 
example, the sequence 



USE 


X 


CLA 


= 1 


ADD 


=2 


LITORG 




USE 


Y 


CLA 


= 3 


ADD 


=4 


LITORG 




USE 


X 


END 





would begin the first Literal Pool (containing 1 and 2 ) 
at symbolic location A and the second Literal Pool 
(containing 3 and 4) at symbolic location B. 

Any literals encountered following a litorg are posi- 
tioned at the next litorg or, if there is none, under 
the control of a lorg pseudo-operation. If there is 
neither a lorg nor another litorg, subsequent literals 
follow an *lorg generated immediately preceding the 
end card. 

Under litorg control, duplicate literals are elimi- 
nated within each litorg section. 



Data-Generating Pseudo-Operations 

Five pseudo-operations (oct, dec, bci, lit, and vfd) 
provide the programmer with a convenient means of 
introducing data expressed in a variety of forms into a 
program during assembly. Numbers introduced by 
these operations are often referred to as constants. A 
sixth pseudo-operation, dup, permits a sequence of sym- 
bolic cards to be duplicated a specified number of 
times. 

The OCT Pseudo-Operation 

The oct (Octal Data) pseudo-operation introduces 
binary data expressed in octal form into a program. 
The format of the oct pseudo-operation is : 
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OPERATION 




NAME FIELD 


FIELD 


VARIABLE FIELD 


Symbol 


OCT 


1. One or more octal inte- 
gers, separated by com- 
mas, or 

2. Blanks 



Each subfield in the variable field contains a signed 
or an unsigned octal integer of n digits, where n ^ 12. 
The only limit on the number of subfields is that they 
must all be contained in the variable field of one card. 



'HriciDJC hgiQ results in a. wuru 



fir •-* 1 1 ••.Hrri.s 



The oct operation converts each subfield to a binary 
word. These words are assigned to successively higher 
storage locations as the variable field is processed 
from left to right. If a symbol is used in the name field, 
it is assigned to the first word of data generated. 

For example, each of the instructions 



ALPHA 
ALPHA 
ALPHA 



OCT 
OCT 
OCi 



777777777777 

-777777777777 

-377777777777 



would result in a binary word of 36 consecutive ones 
at location alpha. 

In the instruction, 

ALPHA OCT 43,25,64 

the binary equivalent of octal number 43 would appear 
at location alpha, the binary equivalent of 25 at loca- 
tion alpha +i, and the binary equivalent of 64 at 

ALPHA + 2. 

The DEC Pseudo-Operation 

The dec ( Decimal Data ) pseudo-operation introduces 
data expressed as decimal numbers into a program. 
The format of the dec pseudo-operation is: 





OPERATION 




NAME FEELD 


FIELD 


VARIABLE FIELD 


1. A symbol, or 


DEC 


1. One or more decimal data 


2. Blanks 




items, separated by com- 
mas, or 
2. Blanks 



The only limit on the number of subfields is that 
they must all be contained in the variable field of one 
card. 

A blank variable field results in a word of all zeros. 

The dec operation converts each subfield to one or 
two binary words, depending on whether the decimal 
data item is single or double precision. These words 
are stored in successively higher storage locations as 
the variable field is processed from left to right. A 
symbol used in the name field is assigned to the first 
word of data generated. 

For example, the instruction 

ALPHA DEC 43,25 



would result in the binary equivalent of decimal num- 
ber 43 appearing at location alpha anu or uecimal 
number 25 appearing at location alpha + i. 

The BCI Pseudo-Operation 

The bci ( Binary Coded Information ) pseudo-operation 
introduces binary-coded decimal data into a program. 
Each data word generated consists of six 6-bit char- 
acters in standard bcd code. The format of the bci 
pseudo-operation is: 





OPERATION 




NAME FIELD 


FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


BCI 


Two subfields, separated by 
a comma: 

1. Single-digit count or 
symbol, 

2. Alphameric data 



If a digit is used in the count subfield, it must be a 
single digit from 1 through 9. 

A null subfield indicates a count of ten. To accommo- 
date the full ten words of data on the card, the null 
subfield must be indicated by a comma in column 12. 

The data subfield contains any desired alphameric 
information (see Appendix E for the map bcd char- 
acter code ) . 

The length of the data subfield is determined by the 
number of six-character words specified in the count 
subfield. The immediate value of the symbol used in 
this subfield may also be used to determine the length 
of the data subfield. 

The comments field begins immediately after the 
end of the data subfield, and no blank character is 
needed to separate the data subfield from the com- 
ments field. Any part of the data extending beyond 
the limit of the data field is treated as comments. Blanks 
are inserted as required to fill the data subfield to the 
length specified by the count subfield. 

Thus, the bci pseudo-operation introduces data 
words into consecutive locations, the number of words 
generated being equal to the number in the count 
subfield. A symbol used in the name field is assigned 
to the first word of data generated. 

For example, 



ALPHA 



BCI 



2,bPROFITbBISEbINbPER- 
CENT 



would generate the data words profit rise, whereas 
in percent would be comments. 

The VFD Pseudo-Operation 

Each VFD pseudo-operation generates no, one, or more 
than one binary data words and assigns them to suc- 
cessively higher storage locations. The format of the 
vfd (Variable Field Definition) pseudo-operation is: 
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NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


VFD 


Any number of subfields, 
separated by commas 



Each subfield of the variable field generates zero, one, 
or more than one bits of data. Thus, the unit of informa- 
tion for this pseudo-operation is the single bit. 

Each subfield may be any one of three types: octal 
(Boolean), alphameric, or symbolic (including deci- 
mal integers). 

The subfield of the vfd pseudo-operation consists of: 

1. The type letter 

a. The letter O signifies an octal ( Boolean ) field. 

b. The letter H signifies an alphameric field. 

c. The absence of either O or H signifies a sym- 
bolic or decimal field. 

2. The bit count — either a decimal integer or an 
immediate symbol specifies the number of bits to be 
generated by the subfield. If an immediate symbol is 
used, care should be taken to avoid confusion caused 
by the type letter. The maximum allowable bit count 

(r\r ct ciT-irrle» cnKfioIr? ie Rfi4 

3. The separation character slash (/) 

4. The data item 

a. In an octal subfield, the data item may be a 
Boolean expression or an octal number. 

b. In an alphameric subfield, the data item is a 
string of characters none of which is a comma 
or a blank. 

c. In a symbolic subfield, the data item is one 
expression. The item is taken modulo 2 20 . 

Any number of subfields may be used. Successive 
subfields of the variable field are converted and packed 
to the left to form generated data words. If n is the bit 
count of the first subfield, the data item in that sub- 
field is converted to an n-bit binary number that is 
placed in the leftmost n positions of the first data word 
to be generated. If n exceeds 36, the leftmost 36 bits 
of the converted data item form the first generated 
data word and the remaining bits are placed in the 
first ( n — 36 ) bit positions of the second generated data 
word. 

Each succeeding subfield is converted and placed 
in the leftmost bit positions remaining after the pre- 
ceding subfield has been processed. If the total number 
of bit positions used is not a multiple of 36, the unused 
bit positions at the right of the last generated data 
word are filled with zeros. 

If the data item is a single signed octal integer of 
any length, the sign is recorded as the high-order bit 
of the specified bit group. 



If after conversion a symbolic or octal item occupies 
more than n bits, only the rightmost n bits of the con- 
verted data item are used. If the converted data item 
occupies fewer than n bits, enough zero bits are placed 
at the left of the converted data item to form an n-bit 
binary number. Neither condition is regarded as an 
error by the assembly program. 

The data item in a symbolic subfield is converted 
as a symbolic expression. Decimal integers must not 
exceed 32767. 

The data item in an octal subfield may be any valid 
Boolean expression. In addition, a signed or unsigned 
octal integer, which may exceed 18 bits, will be recog- 
nized and accepted by the assembly program. 

The data item in an alphameric subfield may consist 
of any combination of characters other than a comma 
or a blank. Each character is converted to its 6-bit 
binary code equivalent. If the converted data item 
occupies more than n bits, only the rightmost n bits 
are used. If the converted data item occupies fewer 
than n bits, sufficient 6-bit groups of the form 110000 
( the bcd code for blank ) are placed at the left of the 
converted data item to form an n-bit binary number. If 
n is not a multiple of 6, the leftmost character or blank 
is truncated. None of these conditions is regarded as 
an assembly error. 

For example, the vfd pseudo-operation could be 
used to break up a 36-bit word as follows: Positions S 
and 1 through 9 must contain the binary equivalent of 
the decimal integer 895, positions 10 through 14 must 
contain the binary equivalent of the octal integer 37, 
positions 15 through 20 must contain the binary equiv- 
alent of the character C, and positions 21 through 35 
must contain the value of the symbol alpha. The in- 
struction to generate this word is 

VFD 10/895,O5/37,H6/C, 15/ALPHA 

The LIT Pseudo-Operation 

The lit (Literal) pseudo-operation places data items 
from the subfields of the variable field into the Literal 
Pool in successively higher storage locations. 
The format of the lit pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


LIT 


Data subfields, separated by 
commas 



Rules for the contents of the data subfields are the 
same as those governing literals except that the equal 
sign ( = ) is omitted. 

A Literal Pool entry made using a lit pseudo-opera- 
tion is assumed to be double precision if the variable 
field generates only two consecutive words of data. If 
a double-precision entry is made in the Literal Pool 
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by either a lit pseudo-operation or a double-precision 
literal, the number is placed in an even location rela- 
tive to the beginning of the Literal Pool. (In this re- 
spect, the assembly program does not distinguish 
double-precision floating-point numbers from double- 
precision fixed-point numbers. ) 
For example, 

LIT 1,2 

causes the number 1 to be placed in an even location 
relative to the beginning of the Literal Pool (which 
can result in duplicate entries in the Literal Pool ) . 
The instruction 



For example, the sequence 



LIT 



1EE1 



results in a double-precision entry beginning in an 
even location in the Literal Pool, but the instruction 

LIT 1EE1,2 

results in a three-word entry with the first word not 
necessarily entered into an even location. 

Thus, double-precision floating-point numbers may 
be used as constants if an even pseudo-operation is 
used immediately preceding the lorg operation or, if 
no lorg is present, immediately before the end pseudo- 
operation. 

The DUP Pseudo-Operation 

The dup (Duplicate) pseudo-operation causes an in- 
struction or sequence of instructions to be duplicated. 
An important application is in generating tables. The 
format of the dup pseudo-operation is: 





OPERATION 




NAME FIELD 


FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


DUP 


Two subfields, separated by 
a comma: 

1. An expression 

2. An expression 



The first subfield represents instruction count, and 
the second subfield represents iteration count. Integers 
are generally used in these subfields. Symbols in the 
instruction count and iteration count subfields are 
evaluated for their S-values. 

If m represents instruction count and n represents 
iteration count, the dup pseudo-operation has the effect 
of duplicating the next m instructions n times. 

The group of m instructions following the dup es- 
tablish the range of the dup. The effect of the dup 
pseudo-operation is that the set of m symbolic cards 
making up the range is copied n — 1 times and placed in 
the symbolic deck behind the original set. (The name 
field of the symbolic card is duplicated. ) An iteration 
count of zero causes the entire range to be omitted. 



DUP 


2,3 


PZE 


X 


PZE 


Y 


quence 
PZE 


X 


PZE 


Y 


PZE 


X 


PZE 


Y 


PZE 


X 


PZE 


Y 



With the sole exception of the end pseudo-operation, 
any operation may appear within the range of a dup, 
including another dup. 

If a dup pseudo-operation occurs within the range 
of a preceding dup, the two (or more) dup pseudo- 
operations are said to be nested. As in most cases of 
nesting, the effect of nested dup pseudo-operations must 
be determined beginning with the innermost one and 
working out. If the explicit range (the instruction 
count) of the inner dup extends beyond the range of 
an outer dup, the implicit range of the outer dup is 
extended to the farthest point covered by the inner 
dup. The first card to be processed after such a series 
of dup pseudo-operations is the next card beyond both 
explicit and implicit dup ranges. 

For example, the operation 

DUP m,n 

In the nested dup pseudo-operations in the sequence 



DUP 


1,2 


DUP 


1,2 


PZE 


X 


FL& 


z 



the single card to be duplicated by the outer dup is the 

inner dup, and the effect of the inner dup is actually the 

two operations 

PZE X 

PZE X 

The sequence generated when the outer dup is ex- 
panded is 

PZE X 

PZE X 

PZE X 

PZE X 

PZE Z 

where the last card in the sequence is the first card 
beyond both the explicit and implicit ranges of the 
outer dup. 

In the sequence 



DUP 


3,2 


DUP 


1,2 


PZE 


X 


PZE 


Y 


PZE 


Z 
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The effect of the inner dup is the sequence 



PZE 
PZE 



The range of the outer dup includes the two instruc- 
tions resulting from the expansion of the inner dup 
plus the two instructions following, i.e., pze x and 

PZE Y. 



Thus, the expansion of 
sequence 

PZE 
PZE 
PZE 
PZE 
PZE 
PZE 
PZE 
PZE 
PZE 



the outer dup gives the 



The range of a dup that occurs within the range of 
another dup must be fixed before the outer dup is en- 
countered. This can be done by using the set pseudo- 
operation. (See the section "The set Pseudo- 
Operation.") For example, the sequence 

K 
K 

will result in an error message and assembly will be 
terminated. However, the iteration count may be vari- 
able. For example, the sequence 



SET 


1 


DUP 


2,2 


SET 


K + l 


DUP 


K,n 



K SET 


1 


DUP 


2,2 


K SET 


K + l 


DUP 


m,K 


is valid and will be assembled < 


the sequence 




K SET 


1 


DUP 


2,2 


K SET 


K + l 


DUP 


3,K 


PZE 


X 


PZE 


Y 


PZE 


Z 


would result in 




PZE 


X 


PZE 


Y 


PZE 


Z 


PZE 


X 


PZE 


Y 


PZE 


Z 


PZE 


X 


PZE 


Y 


PZE 


Z 


PZE 


X 


PZE 


Y 


PZE 


Z 


PZE 


X 


PZE 


Y 


PZE 


Z 



Symbol-Defining Pseudo-Operations 

map provides a group of pseudo-operations specifically 
designed to define the symbols that appear in their 
name fields. They are useful in a variety of program- 
ming applications, such as equating symbols to com- 
bine separately written program segments or changing 
parameters referred to symbolically throughout a pro- 
gram by redefining the symbol. 

The EQU and SYN Pseudo-Operations 

The equ and syn pseudo-operations are identical. The 
format of the equ and syn pseudo-operations is : 





OPERATION 




NAME FIELD 


FIELD 


VARIABLE FIELD 


Symbol 


EQU 


One or two subfields, 




or 


separated by a comma: 




SYN 


1. Any expression, 

2. Modal and dimensional 
information 



The equ and syn pseudo-operations give the name 
field symbol the same definition — and the same struc- 
ture — as the expression in the first subfield of the 
variable field. Thus, if A is defined as X + Y — Z and 
the instruction 

B EQU A 

is given, B is defined as X + Y — Z. The instruction 

LCS EQU * 

defines lcs as having the current value of the location 
counter. 

When the second subfield is used, it supplies to the 
debugging dictionary modal and dimensional informa- 
tion about the symbol in the name field. This sub- 
field must be used if the symbol in the name field 
also appears in the variable field of a keep pseudo- 
operation. (See the publication IBM 7090/7094 IBSYS 
Operating System: IBJOB Debugging Package, Form 
C28-6393. ) The format for this entry is 

mode ( di, d 2 , d 3 ) 
where d 1? d 2 , and d 3 are the dimensions, if any, of the 
array denoted by the symbol in the name field, and 
mode is one of the letters o, f, x, d, j, l, s, c, or h, as 
explained in the discussion of the bss pseudo-opera- 
tion. 

If the mode is omitted or is a symbol other than the 
nine listed above, it is assumed to be octal. Dimensions 
must be decimal integers or an error message is issued. 

The NULL Pseudo-Operation 

The format of the nutj, psen do-opera Hon is: 



The variable field of a dup pseudo-operation cannot be 
extended by use of the etc pseudo-operation. 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


NULL 


Ignored 
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The null pseudo-operation defines the symbol in the 
name field, if any. as having the current value of the 
location counter. The operation 

LCS NULL 

is equivalent to 

LCS EQU * 

except that null is preferred. 

The MAX Pseudo-Operation 

The max pseudo-operation gives the symbol in the 
name field an absolute value equal to the expression 
in the variable field that has the maximum defined 
value. The format of the max pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


MAX 


Expressions, separated by 
commas 



The maximum value is computed as if all symbols were 
absolute. The comparison is made after negative values 
have been complemented. For example, the sequence 



A 
ALPHA 



BSS 

MAX 

EQU 



is equivalent to 



BSS 



100,ALPHA, ALPHA- 100 
150 



150 



The MIN Pseudo-Operation 

The effect of the min pseudo-operation is opposite to 
that of max. The symbol in the name field is given an 
absolute value equal to the expression in the variable 
field having the minimum defined value. The format 
of the min pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


MIN 


Expressions, separated by 
commas 



The minimum value is computed as if all symbols were 
absolute. The comparison is made after negative values 
have been complemented. For example, the sequence 



A 
ALPHA 



BSS 

MIN 

EQU 



is equivalent to 



BSS 



100,ALPHA,ALPHA- 100 
150 



50 



The SET Pseudo-Operation 

The set pseudo-operation causes the symbol in the 
name field to be defined immediately. The set pseudo- 
operation, which can be used to define symbols in both 
machine instructions and pseudo-operations, is often 
used to define the symbols in the variable fields of the 
dup, vfd, ift, and iff pseudo-operations. The format 
of the set pseudo-operation is: 



OPERATION 
NAME FIELD FIELD 


VARIABLE FIELD 


Symbol SET 


Any expression 



Qualified symbols may not be used in the variable field. 
If an * is used as a location counter reference in the 
variable field, the assembler treats it as an ordinary 
symbol, gives it an S-value of zero, and issues an 
error message. 

The symbol in the name field is immediately assigned 
the value ( called the S-value ) of the variable field ex- 
pression during the first pass of the assembly program. 
Thus, the set pseudo-operation enables the program- 
mer to use sequences of instructions in which decisions 
depend on the value assigned to a symbol during the 
first pass of the assembly program. It also permits sym- 
bols to be redefined repetitively. The value assigned 
to the symbol is always a 15-bit integer. 

Use of the set pseudo-operation is subject to the 
following conditions: 

1. Immediate symbols may not be qualified. 

2. An immediate symbol used in the variable field 
of a pseudo-operation affecting location counters ( such 
as bss) assumes the final value assigned to it in the 
program. For example, the sequence 

A SET 100 

BSS A 

A SET 1000 

END 

is equivalent to 

BSS 1000 

3. An immediate symbol should not normally be 
given a name identical to an ordinary symbol, since 
doing so can result in multiple definition. 

An example of the use of the set ^seudo-o^eration 
to assign a value to a symbol during the first pass of 
the assembly program is shown in the following se- 
quence. 

ALPHA SET 50 

VFD ALPHA/BETA 

By using the set pseudo-operation, the value of 
alpha can be changed without altering the vfd in- 
struction. A similar use of immediate symbols is in 
making conditional assembly decisions with the iff/ift 
pseudo-operations. 

The set pseudo-operation permits a symbol to be re- 
defined repeatedly for such programming functions as 
constructing tables and writing macro-operations. For 
example, in the sequence 

ALPHA SET 1 

DUP 2,9 

PZE ALPHA 

ALPHA SET ALPHA + 1 

alpha is first assigned a value of 1 and then redefined 
nine times with its value incremented by 1 at each 



iter 



ion. 
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Boolean Pseudo-Operations 

The Boolean pseudo-operations define symbols as 
Boolean quantities. 



The BOOL Pseudo-Operation 

The bool (Undesignated Boolean) pseudo-operation 
functions like the equ pseudo-operation except that the 
variable field expression is Boolean and the name field 
symbol becomes a Boolean symbol. The format of the 
bool pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


BOOL 


A Boolean expression 



bool defines the symbol in the name field as an 18-bit 
constant. Relocatable symbols or virtual symbols used 
in the variable field result in an error. Octal integers 
in the variable field may not exceed six characters. 



The RBOOL and LBOOL Pseudo-Operations 

The format of the rbool (Right Boolean) and lbool 
(Left Boolean) pseudo-operations is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


RBOOL 

or 
LBOOL 


A Boolean expression 



Relocatable symbols or virtual symbols used in the 
variable field result in an error. Octal integers in the 
variable field may not exceed six characters. 

These pseudo-operations are similar to bool except 
that the symbol in the name field is defined as right 
(left) Boolean. They are normally used to determine 
the correct machine operation for the special type D 
instructions ( sib, bnt, bft, iib, and rib ) . The following 
mechanism is used. 

1. If the expression in the variable field of an sib 
instruction is entirely left ( right ) Boolean, the instruc- 
tion is assembled as sil ( sir ) . Constants are considered 
to be both left and right Boolean. If the expression is a 
mixture of both left and right Boolean, sil is assembled 
but a warning message is issued. 

2. If the variable field of an sil (sir) instruction is 
not purely left (right) Boolean, left (right) and un- 
designated Boolean, or purely undesignated Boolean, 
a warning message is issued. 

For example, following the instructions 



the instruction 






BFT 


X 


assembles as LFT 123 


BNT 


Y 


assembles as RNT 456 


IIB 


Z 


assembles as IIR 321 


RIB 


Y + Z 


assembles as RIR 777 


SIB 


Y+Z 


assembles as SIL 323 



A warning message is issued for the last instruction 
( sib ) because of the mixture of left and right Boolean. 



Conditional-Assembly Pseudo-Operations 

Two pseudo-operations provided by map enable the 
programmer to specify that the next instruction is to 
be assembled only if certain criteria are met. Another 
pseudo-operation, goto, may be used with the condi- 
tional-assembly pseudo-operations to extend their 
effect over more than one instruction. 

The IFT and IFF Pseudo-Operations 

The ift ( If True ) and iff ( If False ) pseudo-operations 
specify conditions that determine whether the next 
sequential instruction will be assembled. The format 
of the ift and iff pseudo-operations is: 





OPERATION 


1 1 


NAME FIELD 


FIELD 


VARIABLE FIELD 


Blanks 


IFT 


1. element— relational opera- 




or 


tor—element 




IFF 


2. If present, either of the 
words OR or AND, pre- 
ceded by a comma 



X 


LBOOL 


123 


Y 


RBOOL 


456 


Z 


RBOOL 


321 



The ift (iff) pseudo-operation assembles the next 
instruction if the condition expressed by the operation 
and the first subfield is met. 

A relational operator consists of one or two adjacent 
symbols signifying: 

= Equals 

= + Greater than 

= — Less than 

The elements at the left and right of these relations 
must not be qualified. The element is used in one of 
two ways: 

1. To represent a numerical value equal to its S-value 

2. To represent literal bcd information, in which case 
it is surrounded by slash ( / ) marks 

Interpretation of the relational operator depends on 
the context. If the elements represent bcd, the relation 
is a scientific collating sequence comparison. For ex- 
ample, 

IFT /A/=+/B/ 

is false and would therefore not permit assembly of the 
next instruction. However, 

IFT /A/=-/B/ 

is true and would permit assembly of the next instruc- 
tion. 
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Also, 

IFF // — /A/ 

compares blank to A and would permit assembly of 
the next instruction. 

If the elements represent a numeric quantity, the re- 
lation is a numeric comparison. The programmer must 
avoid noncomparable elements. 

Presence of the second subfield signifies that another 
ift or iff is to follow, in which case the combined effect 
of the two is either a logical or or a logical and. 

i ne 5- value anc not trie Gennition is useci m iiunieriu 
evaluation of symbols. The set pseudo-operation may 
be used to control iff or ift pseudo-operations, as in 
the sequence 

K 



SET 
IFT 



4 
K=4 



This statement is true, and the next instruction will be 
assembled. 

The fact that the conditional assembly extends over 
only one instruction is not a serious restriction, since 
the following instruction may be another ift or iff 
pseudo-operation, a goto pseudo-operation, or a 
macro-operation that expands to any length (see the 
section "Conditional Assembly in Macro-Operations" ) . 

The variable field of an iff or ift pseudo-operation 
may not be extended by using the etc pseudo-opera- 
tion. 

The GOTO Pseudo-Operation 

The goto pseudo-operation, when used with an ift 
or iff pseudo-operation, provides the map programmer 
with a method for either assembling or skipping 
blocks of instructions. The format of the goto pseudo- 
operation is: 



NAME FIELD 


OPERATION 

FIELD 


VARIABLE FIELD 


Blanks 


GOTO 


One or two subfields, 
separated by a comma : 

1 . Symbol, which may be 
followed by a comma when 
used alone, 

2. The word BLANK, which 
may be followed by a comma 



The goto pseudo-operation causes all instructions 
following it, up to but not including the instruction 
whose name field contains the symbol specified in the 
vanabic ncid Ox tuis pseuQO-operation, to be sKippeu 
during assembly. 

If the blank option is present, the symbol in the 
variable field will not be entered into the dictionary 
but will appear on the listing. Therefore, the symbol, 
which may be completely numeric, may be reused. 

If the variable field does not end with a comma, the 
skipped instructions are listed as comments. If the 



terminating comma is present, listing of skipped in- 
structions is suppressed. 
For example, the sequence 



CLA 


X 


IFT 


A = l 


GOTO 


LCS 


STO 


Z 


CLA 


B 


LCS TSX 


SUB,4 


\x7rnilrl nrnnnnp 




CLA 


X 


LCS TSX 


SUB,4 


if A had previously been defined as 1, and 


CLA 


X 


STO 


z 



CLA B 

LCS TSX SUB.4 

if A had been defined as some value other than 1. 

In this example, the instructions omitted would be 

listed and lcs would be entered into the dictionary. 

Alternate forms would be 

GOTO LCS.BLANK ( LCS not entered, cards listed ) 

GOTO LCS, ( LCS entered, no list ) 

GOTO LCS,BLANK, ( LCS not entered, no list ) 

If a goto occurs within a macro-definition and the 
referenced symbol is outside the definition, only the 
instructions between the goto and the endm pseudo- 
operation are skipped. If a goto references past an 
irp pseudo-operation, only the instructions between 
the goto and the irp are skipped. The irp iterations 
will not be terminated if any subarguments are left 
to be processed. 

Symbol-Qualifying Pseudo-Operations 

map provides two pseudo-operations, qual and endq, 
that enable a programmer to qualify symbols within 
sections of a program. 

The QUAL Pseudo-Operation 

All symbols between the qual pseudo-operation and 
its associated endq pseudo-operation are qualified. The 
format of the qual pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


QUAL 


Symbol 



The symbol in the variable field qualifies all symbols 
defined within the section controlled by the qual pseudo- 
operation. References to a symbol defined in a qualified 
section from within the same section need not be qual- 
ified. References from outside the section are qualified 
by placing the section symbol (variable field symbol 
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of the qual pseudo-operation ) in front of a connecting 
dollar sign followed by the desired symbol. For ex- 
ample, the symbol qssalpha refers to symbol alpha 
defined in qualified section qs. The notation sbeta re- 
fers to symbol beta, which is not qualified. The un- 
qualified section effectively has a blank qualifier. 

Qualified sections may be nested to provide multiple 
qualification. The range ( from a qual to its correspond- 
ing endq) of a lower-level qual must fall completely 
within the range of the next higher qual. A symbol is 
automatically qualified by any qualifiers of a higher 
level than the highest one specified in using the symbol. 
A multiply qualified symbol can be referenced without 
using all the qualifiers if enough qualifiers are given 
to determine the symbol uniquely. In any case, the 
qualifiers must be specified in the same order that nest- 
ing occurs within that section. 

A sequence illustrating qualification is 



QUAL 

BSS 

CLA 

ENDQ 

QUAL 

BSS 

ENDQ 



Qualified 
Section H 

Qualified 
Section J 



the first definition of A; X written as j$a refers to the 
second definition of A. 

In the sequence of nested qualification 



QUAL 


M 




\ 


BSS 


1 




1 


QUAL 


N i 


Qualified 


f Qualified 


CLA 


X 


Section 


/ Section M 


ENDQ 


N ( 


M$N 


\ 


ENDQ 


M 




/ 


BSS 


1 






CLA 


Y 







X written as A refers to the first definition of A; X 
written as $a refers to the second nonqualified A. 
Y written as A refers to the second A; Y written as 
m$a refers to the first A. 
In the more complicated sequence 



QUAL ONE 

BSS 1 

§ s u s AL r°)Q ualified 

rTA Y > Section 

Sw> woj ONEmvo 

CLA Y 

ENDQ ONE 



Quali- 
fied 
Section 
ONE 



QUAL THREE \ 

A BSS 1 ) Quali- 

QUAL TWO I Qualified ( fied 

A BSS 1 > Section ( Section 

ENDQ TWO \ THREE$TWO \ THREE 

ENDQ THREE / 

X refers to the first A by onesa; to the second A by A, 
by twosa, or by onestwosa; to the third A by threesa; 
and to the fourth A by three$two$a. 



Y refers to the first A by A or by onesa; to the second 
A by twosa or by onestwosa; to the third A by 
threesa; and to the fourth A by threestwosa. In this 
sequence, the two sections two are distinct and not 
separate parts of the same section. The first is section 
onestwo, and the second is section threestwo. 

The ENDQ Pseudo-Operation 

The format of the endq pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


ENDQ 


Either: 

1. A symbol, or 

2. Blanks 



endq delimits the range of the qualified section 
whose symbol is in the variable field of this instruction. 
If the variable field is blank, the innermost qualified 
section is terminated. However, a low-severity warning 
message is issued, since a variable field inadvertently 
left blank can result in errors when using nested quali- 
fication. 

In nested qualified sections, a separate endq is re- 
quired to terminate each qualified section. Also, quali- 
fied sections must be terminated in order beginning 
with the lowest level section as shown in the following 
sequence, or an error message will be issued. 



QUAL 



ALPHA 



QUAL BETA 



QUAL 



GAMMA 



ENDQ GAMMA 



ENDQ BETA 



ENDQ 



ALPHA 



Control-Section Pseudo-Operations 

Relocatable programs can be divided into segments. 
By dividing large programs into relocatable segments, 
individual segments can be coded and checked in 
parallel, with consequent savings in time. Also, a seg- 
ment can be modified without requiring reassembly of 
the entire program. 

The control-section pseudo-operations provide the 
means for making references to and from such seg- 
ments, ibldr makes the cross-references among pro- 
gram segments that are assembled separately but 
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loaded together. (For further information, see the 
publication IBM 7090/7094 IBSYS Operating System: 
IBJOB Processor, Form C28-6389.) 

Each program segment is a control section. In addi- 
tion, sections within segments may be designated as 
control sections by the programmer. 

ibldr treats control sections as being variable. A 
control section may be replaced by another control 
section or even deleted entirely. If more than one 
control section is given the same designation, generally 
only the first control section is retained. 

An even appearing within a control section must 
have the same relative location as the beginning of 
the control section. This will result in the first loca- 
tion of the control section being assigned an even 
location at load time. Thus, an instruction or data 
within a control section will be assigned to an even 
location if it appears an even distance from the con- 
trol section origin. 

The CONTRL Pseudo-Operation 

The contrl pseudo-operation designates a program or 
a part of a program as a control section. The format of 
the contrl pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


CONTRL 


One of the following: 

1. A location counter sym- 
bol, or 

2. A qualification symbol, or 

3. Two subfields, separated 
by a comma, each contain- 
ing an ordinary symbol 



The contrl pseudo-operation delimits the control 
section named in the name field in accordance with 
the contents of the variable field. If a location-counter 
symbol is used in the variable field, all instructions 
under control of the specified location counter are 
delimited. The blank location counter cannot be used 
as a control section. If a qualification symbol is used, 
all instructions between the specified qual pseudo- 
operation and its associated endq pseudo-operation are 
delimited. If two subfields are used, all instructions are 
delimited beginning at the location specified by the 
first symbol and ending at, but not including, the lo- 
cation specified by the second symbol, contrl pseudo- 
operations that refer to absolute symbols, or to loca- 
tion symbols whose definitions depend on an absolute 
origin within a relocatable assembly, are discarded 
and an error message is issued. An error message will 
also be given if a qualification symbol or location 
counter symbol defining a control section falls under 
an absolute origin. If the absolute origin occurs within 
the control section, no diagnostic will be given and 
relocation errors may occur during loading. 

If there is no symbol in the name field, the first sym- 
bol in the variable field is taken as the external name 



of the control section and a low-severity message is 
issued. The length of a control section is always the 
difference between the value of the location counter in 
control at the end of the section and its value at the 
beginning of the section. Hence, the use of org or use 
pseudo-operations within control sections may result 
in incorrect length calculations, in effect, "losing" in- 
structions from the section. Text which has been 
placed within a control section by use of an org 
pseudo-operation cannot be deleted. Therefore, if sev- 
eral of such control sections with the same external 
name occur, the text from the last one encountered 
during loading will be used. If all of such control 
sections with the same external name are deleted, ex- 
ecution will be suppressed because of the resulting 
virtual reference which cannot be defined. 

The contrl pseudo-operation may appear anywhere 
in the program. In an absolute assembly, a low-severity 
error message is printed, but contrl is otherwise 
ignored. For example, 

X CONTRL A,B 

defines the portion of the program from A to, but not 
including, B as control section X. 

Control sections may be nested. 

To obtain the blank common area, as used by 7090/ 
7094 Fortran iv, an instruction of the form 

CONTRL // 

must be used. For example, in the sequence 

CONTRL // 
USE A 



TJSF, 



USE 


// 


BSS 


20 


USE 


C 



USE 



END 



the blank common counter // will have its initial lo- 
cation defined as the last value reached by location 
counter C. The area under control of trie // counter is 
a control section. 

The ENTRY Pseudo-Operation 

The entry pseudo-operation provides a reference from 
outside a program segment to a point within the pro- 
gram segment. The format of the entry pseudo-opera- 
tion is: 
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NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, 

or 

2. Blanks 


ENTRY 


Symbol 



The name field symbol becomes the external name of 
the entry point. The variable field symbol is the in- 
ternal name of the entry point and must be an ordinary 
symbol, although it may be qualified. If the name field 
is blank, the variable field symbol serves as the external 
name. If the variable field symbol is qualified, the ( left- 
most) qualifier is used. For example, 

ALPHA ENTRY BETA 

specifies that alpha is the external name of an entry 
point into this program from another program and that 
beta is the internal name of this entry point. 

If an entey pseudo-operation refers to either an 
absolute symbol, a symbol that was defined by an 
equ or syn pseudo-operation, or a location symbol 
whose definition depends on an absolute origin within 
a relocatable assembly, it is discarded and an error 
message is issued. 



File-Description Pseudo-Operations 

Two pseudo-operations are provided by map for spec- 
ifying input/output file requirements in relocatable 
assemblies. These pseudo-operations describe files that 
are used in conjunction with Library iocs. (See the 
publication IBM 7090/7094 IBSYS Operating System: 
Input/Output Control System, Form C28-6345. ) 

ibldr generates a file control block and assigns the 
file to a buffer pool. File control blocks described in one 
program segment may be referenced in other segments. 
If the same file is described more than once, only the 
first description is effective. 

The FILE Pseudo-Operation 

The file pseudo-operation enables the programmer to 
specify input/output file requirements. The file 
pseudo-operation causes generation of a sfile card, as 
well as any $etc cards needed. The format of the file 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


FILE 


External file name, options, . . . 



The symbol in the name field of the file pseudo- 
operation is the internal name of the file used by the 
programmer within his program. Whenever this name 
appears in the variable field of an instruction, the re- 
locatable reference is to the generated file control 
block for this file. 



The first subfield of the variable field is the external 
file name. The order of the subsequent subfields is 
arbitrary. 

In describing the subfields, options that may be in- 
cluded or omitted are shown in brackets. When an 
option is not specified, the standard option, which is 
shown underlined, is assumed. Braces indicate that a 
choice of the enclosed options is to be made by the 
user. Options are shown in all upper-case letters in the 
form in which they must be specified. Subfields in the 
variable field must be separated by commas. 

External File Name is an alphameric literal of up to 
18 characters used to determine equivalence between 
files. This subfield must be specified as the first subfield 
in the variable field. It may be null (the variable field 
may start with a comma), in which case the six- 
character name field ( left- justified with trailing blanks ) 
is inserted as the external name. 

Unit-Assignment Option 

F, primary unit] [, secondary unit] 

Two symbolic units may be specified for each file: the 
primary unit, and a secondary unit to be used as a reel- 
switching alternate. The format used for these sneni- 

~~" ' ~ ~~ - c ~ — 

fications is indicated below, where the following nota- 
tion is used: 

X a real channel (specified by one of the letters A 
through H) 

P a symbolic channel (specified by one of the letters S 
through Z) 

I an intersystem channel (specified by one of the letters J 

through Q) 

k a unit number (specified by one of the numbers 

through 9) 

a access mechanism number (specified by either of the 

numbers or 1 ) 

m module number (specified by one of the numbers 
through 9) 

s data channel switch or interface (specified by either of 

the numbers or 1 ) 

model number of 729 Magnetic Tape Unit (specified by 
II, IV, V, or VI) 

1301/2302 Disk Storage (specified by the letter D) 
7320 Drum Storage ( specified by the letter N ) 
7340 Hypertape Drive (specified by the letter H) 
The following format is used for assigning units: 



M 

D 

N 
H 



SPECIFICATION 

blank 
M 

X 

P 

X(k) 

PM 



EFFECT 

Use any available unit. 

Use any available 729 Magnetic Tape Unit 

of this model. 

Use any available unit on this channel. 

Use any available unit on ihis channel. 

Use kth available unit on this channel. 

Parentheses are required. 

Use any available 729 Magnetic Tape Unit 

of specified model on designated symbolic 

channel. 
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P(k)M Use fcth available 729 Magnetic Tape Unit 

of specified model on designated symbolic 
channel. Parentheses are required. 

I(k) Use kth. available unit on channel I. Paren- 

theses are required. This specification can 
be used for input and output units. 

I(k)M Use fcth available 729 Magnetic Tape Unit 

of specified model on channel I. Paren- 
theses are required. This specification can 
be used only for output units. 

I ( k ) R Use kth available unit on channel I, and re- 

lease unit from reserve status after use. 
Parentheses are required. 

XDam/s Use 1301/2302 Disk Storage on channel X, 

access mechanism number a, and module 
number m. 

XNam/'s Use 7320 Drum Storage on channel X, 

access mechanism a (0), module number 
m (0, 2, 4, 6, 8) and data channel switch 
setting s ( 0, 1 ) . 

XHk/s Use 7340 Hypertape Drive on channel X, 

unit number k, and data channel switch s. 

IN, INI, IN2 Use the system input unit (SYSIN1) and 

the alternate system input unit (SYSIN2) 
as the primary and secondary units respec- 
tively. 

OU, OU1, OU2 Use the system output unit ( SYSOU1 ) and 

the alternate system output unit ( SYSOU2 ) 
as the primary and secondary units respec- 
tively. 

PP, PP1, PP2 Use the system peripheral punch ( SYSPP1 ) 

and the alternate system peripheral punch 
(SYSPP2) as the primary and secondary 
units respectively. 

UTk Use system utility unit number k. 

CKk Use system checkpoint unit number k. 

RDX Use card reader on channel X. 

PRX Use printer on channel X. 

PUX Use card punch on channel X. 

INT File is internal. 

* An asterisk in the secondary unit field in- 

dicates that the secondary unit of a file is 
to be any unit on the same channel and of 
the same model as the primary unit. 

NONE No units are assigned. A file control block 

is generated but does not refer to a unit 
control block. 



File-Mounting Option 




and/or 



(MOUNTi) 

<READYi } 

_(DEFERi ) 



] 



The file-mounting option governs the on-line message 
to the operator indicating the impending use of an 
input/output unit. The first form applies to both units; 
the second applies to the primary unit when i = l and 
to the secondary unit when i = 2. Two standard options 
are indicated— one is for units assigned to system unit 
functions (ready) and the other is for nonsystem units 
(mount). 



The effects of these operations are: 

MOUNT A message is printed before execution, and a 

stop occurs for the required operator action. 

MOUNT is the standard option for nonsystem 

units. 
READY A message is printed before execution, but no 

stop occurs. READY is the standard option for 

all input/output units assigned to system unit 

functions. 
DEFER A message and operator stop are deferred until 

the file is opened by the IOCS calling sequence. 

TSX .OPEN, 4 

r iiEi linemen me name 

The i form of this option overrides for unit i any 
general option specified. 

As an example of the file-mounting option. 
MOUNTI, DEFER2 
causes the mount action for the primary unit and the 
defer action for the secondary unit. 



Operator File-List Option 
L'j NOLIST \ J 



LIST This file will appear in the operator's mount- 

ing instructions. 

NOLIST No message will be printed unless the 

DEFER option has been specified. 

File-Usage Option 

r /INPUT } 

) OUTPUT ( 

' ) INOUt ( 

_ (CHECKPOINT ( or CKPT ) ) _ 



INPUT 

OUTPUT 

INOUT 



CHECKPOINT 

(or CKPT) 



This is an input file. 

This is an output file. 

This file may be either an input or an 

output file. The object program sets 

the appropriate bits in the file block. 

The file is initially set at input. 

This is a checkpoint file. 



Block-Size Option 

[, BLOCK = xxxx (or, BLK = xxxx)] 
xxxx is an integer ( 0-9999 ) that specifies block size for 
this file. If the block-sequence and/or check-sum op- 
tions ( see below ) are specified, a word must be added 
in determining block size. If the block option is 
omitted, the assembly program assumes a block size 
of 14 for bcd or mxbcd files and 256 for bin and mxbin 
files. 

Activity Option 
[, ACT=xx] 
xx is an integer (0-99) that specifies activity of this 
file in relation to other files. If the activity subfield is 
omitted, activity is assumed to be 1. The activity 
value is used in determining the number of input/ 
output buffers assigned to each buffer pool in the object 
program. 
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Reel-Handling Option 

[" ( ONEREEL l 
» \ MULTIREEL \ 
_( (or REELS) ) 

ONEREEL 
MULTIREEL 
(or REELS) 



for unlabeled files only 



f { NOSEARCH ) 1 
l! ] SEARCH } J 
NOSEARCH 



SEARCH 



No reel switching should occur. 
Reel switching will occur. Every out- 
put file will switch reels if an end-of- 
tape condition occurs. 

for labeled files only 

If an incorrect label is detected when 
opening an input file, IOCS causes a 
stop for operator action. 
If an incorrect label is detected, IOCS 
enters a multireel search for the file 
with the desired label. 



File-Density Option 

(highJ 

LOW 
200 
/556 
800 

HIGH Tape-density switch is assumed to be set so that 
execution of an SDH will result in using correct 
density. 

LOW Tape-density switch is assumed to be set so that 

execution of an SDL will result in using correct 
density 

200 Tape density switch is assumed to be set so that 

execution of an SDL will result in a file-record- 
ing density of 200 cpi. 

556 Tape density switch is assumed to be set so that 

execution of an SDL will result in a file-record- 
ing density of 556 cpi. 

800 Tape density switch is assumed to be set so that 

execution of an SDH will result in a file-record- 
ing density of 800 cpi. 

If a system unit is assigned to this file, system set den- 
sity supersedes the density specified by these options. 



Mode Option 

-/BCD } 

;bin 

'\MXBCD 

_ (mxbin ; 



a 



BCD File is in BCD mode. 

BIN File is in binary mode. 

MXBCD File is in mixed mode, and first record is 

BCD. 
MXBIN File is in mixed mode, and first record is 

binary. 

Label-Density Option 
I" ( SLABEL }-| 

Jhilabel f 

) LOLABEL ( 
_(jFLABEL ;_ 
SLABEL All header label operations performed at 

installation standard density, which is 

currently high density. 
HILABEL All header label operations performed at 

high density. 
LOLABEL All header label operations performed at 

low density. 
FLABEL All header label operations performed at 

same density as file. 



Regardless of these options, the label pseudo-opera- 
tion must be used to specify a labeled file. If label 
density is not specified, all label options are performed 
at the density that is high density at the particular 
installation. 

Block-Sequence Option 



NOSEQ | 
>< SEQUENCE 
L((°rSEQ) ' 
NOSEQ 



SEQUENCE 
(orSEQ] 



Check-Sum Option 
nNOCKSUMj 



Block-sequence word neither checked if 
reading, nor formed and written if 
writing. 

Block-sequence word checked if read- 
ing, or formed and written if writing. 



LJCKSUM 
NOCKSUM 



. 



Check sum neither checked if reading, 
nor formed and written if writing. 
CKSUM Check sum checked if reading, or 

formed and written if writing. 

Check-sum options may not be specified unless a 

block-sequence option has been specified. 

Checkpoint Option 

r \ NOCKPTS ) 1 



L/CKPTS 
NOCKPTS 



I 



No checkpoints initiated by this file. 
Checkpoints initiated by this file. 

Checkpoint-Location Option 

[, AFTER LABEL] 
Checkpoints are written following the label on this file 
when reel switching occurs. If ckpts is specified and 
this field is omitted, checkpoints are written on the 
checkpoint file when reel switching occurs. 
File-Close Option 
■ /SCRATCHY -i 



i PRINT 
PUNCH 
HOLD 

SCRATCH 
PRINT 



L 



File is rewound at end of application. 
File is to be printed and is rewound and 
unloaded at end of application. PRINT 
will appear in on-line removal message 
at end of execution. 

PUNCH File is to be punched and is rewound 

and unloaded at end of application. 
PUNCH will appear in on-line removal 
instructions. 

HOLD File is to be saved and is rewound and 

unloaded at end of application. HOLD 
will appear in on-line removal instruc- 
tions. 

If the unit assigned is system input unit 1, system out- 
put unit 1, or system peripheral punch unit 1, the unit 
will not be rewound and the removal message will not 
be printed. 
Starting Cylinder-Number Option 
[, CYLINDER=xxx (or, CYL=xxx)] 
xxx is the number (000-249 for disk, 000-009 for drum) 
of the starting cylinder for this file. The equals sign is 
required. When disk or drum storage is specified for 
a file, the starting cylinder number must be specified 
by the user. 
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Cylinder-Count Option 

[, CYLCOUNT = xx ( or, CYLCT = xxx ) ] 

xxx is the number (000-250 for disk, 000-010 for drum) 
of consecutive cylinders to be used by this file. The 
equals sign is required. When disk or drum storage is 
specified for a file, cylinder count must be specified 
by the user. 

Disk W rite-Checking Option 
[, WRITECK] 
Write-checking is performed after each disk-write or 
drum-write sequence for this file. 

Hypertape Reel-Switching Options 

[- /HRFP } -j 
JHRNFP f 
)HNRFP ( 

L' hnrnfp ) J 

These options may be used in conjunction with the 
Hypertape option, hyper, where reel switching is likely 
to occur. If any of these options are used but hyper 
is not specified, a warning message is issued. 
The effects of these options are: 

HRFP Hypertape, rewind, file protect. 

HRNFP Hypertape, rewind, no file protect. 

HNRFP Hypertape, no rewind, file protect. 

HNRNFP Hypertape, no rewind, no file protect. 

Five subfields provide information for cross-check- 
ing by ibldr. These subfields, the conversion, block- 
size check, nonstandard label routine, Hypertape, and 
pool-attachment options, are not placed on the $file 
card. 



n 



Conversion Option 

' i NOHCVN ) ~) 

] REQHCV [■ I 

L_(OPTHCV j_j 

NOHCVN Alphameric-to-BCD conversion routine not 

necessary. File may not be assigned to 
card equipment. 

REQHCV Alphameric-to-BCD conversion routine re- 

quired. File must be assigned to card 
equipment. 

OPTHCV Alphameric-to-BCD conversion optional. 

Regardless of the conversion options specified, it is the 
responsibility of the programmer to provide the re- 
quired conversion routines. File may be assigned to 
any input/output device. 

Block-Size Check Option 

nMULTI=xxxxn 

L]MIN=xxxx fj 

MULTI=xxxx Block size is a multiple of xxxx. 

MIN=xxxx Minimum block size is xxxx. 

Only one of the block-size check options may appear. 
The quantity specified is used by ibldr ro check the 
block size indicated by the block option. If neither 
option appears, block size is assumed to be exactly 
that specified by the block option. 



Nonstandard-Label-Routine Option 
[,NSLBL= symbol] 
The symbol is the name of a nonstandard-label routine. 
If the label routine is part of the program segment 
being assembled, the label routine must be made a 
control section with the symbol used as its external 
name. If the label routine is not part of this program 
segment, the symbol must be a virtual symbol. 

Hypertape Option 
[ ,HYPER ] 
hyper must be specified if a program requires Hyper- 
tape for a particular file. If reel switching may occur, 
the Hypertape reel-switching options may be used in 
conjunction with hyper. However, use of Hypertape 
reel-switching options without specifying hyper re- 
sults in a warning message. 

If a file may be attached to a Hypertape or a 729 
Magnetic Tape Unit, the hyper specification is not 
necessary. 

Pool- Attachment Option 



f j POOL M 
L ( NOPOOL J J 



POOL 

NOPOOL 
POOL 
NOPOOL 



This file is to be attached to a pool. 

A file control block is to be generated, but 

this file is not to be attached to a pool. 

If a checkpoint (or ckpt) is specified for the file- 
usage option, nopool is automatically assumed. 

If the nopool option is specified, it is assumed that 
the iocs initialization sequences of .defin and .attac 
for this file will be executed by the object program 
prior to opening the file. (See the publication IBM 
7090/7094 IBSYS Operating System: Input/Output 
Control System, Form C28-6345.) 

Example of FILE pseudo-operation 
For example, the options for an input file might be 
specified in the instruction 

INPUT FILE , A ( 1 ) ,RE AD Y,BLK = 20, 

556,HOLD 

Since the first subfield is null, the symbol input in the 
name field is regarded as the external name. The re- 
maining subfields specify the first available unit on 
channel 1, the file-mounting option, a block size of 20 
words, a file density of 556 characters per inch, and the 
file is to be saved and must be rewound and unloaded 
at the end of the application. 

The LABEL Pseudo-Operation 

The label pseudo-operation enables the programmer 
to label a file and causes generation of the slabel con- 
trol card. Whereas the file pseudo-operation describes 
the file characteristics, label simply labels the file. The 
format of the label pseudo-operation is: 
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OPERATION 




NAME FIELD 


FIELD 


VARIABLE FIELD 


1. A symbol, 


LABEL 


Five subfields: 


or 




1. File name, 


2. Blanks 




2. File serial number or disk 
or drum Home Address-2, 

3. Reel sequence number, 

4. Retention period (in days) 
or date, 

5. File identification name 



The file name is an alphameric name of eighteen or 
fewer bcd characters. If this subfield is null (the vari- 
able field begins with a comma), the symbol in the 
name field is inserted as the file name. If the name field 
is also blank, 000000 is inserted as the file name. 

The file serial number is an alphameric subfield of 
five or fewer characters, and it may be null. If the label 
is for a file on disk or drum, this subfield must contain 
two bcd characters to specify the Home Address-2. 
(For further information, see the publication IBM 
1301, Models 1 and 2, Disk Storage and IBM 1302, 
Models 1 and 2, Disk Storage with IBM 7090, 7094, 
and 7094 II Data Processing Systems, Form A22-6785.) 
The reel-sequence number is a numeric subfield of 
four or fewer digits and it may be null. 

For retention period in days, four or fewer numeric 
characters are used. For date, two or fewer numeric 
characters represent the year, and three or fewer 
numeric characters represent the day of the year. The 
year and the day of the year are separated by the 
character / ( slash ) . 

The file identification name is an alphameric subfield 
of eighteen or fewer bcd characters. This subfield may 
contain blanks but not commas. A comma will termi- 
nate this subfield, and excessive subfields will be 
flagged as errors. This subfield may also be null. 

For example, 

LABEL INVOICE„241,63/248,PRIMARY FILE 

specifies that the invoice file be labeled, provides its 
reel-sequence number of 241, dates it as the 248th day 
of 1963, and specifies primary file as the file identifica- 
tion name. 

The variable field of the label pseudo-operation 
must be contained on one card. No etc cards may be 
used following label. 

The variable field is checked for errors. If there are 
more than five subfields, the variable field is truncated, 
only the first five subfields are used, and a warning 
message is printed. If there are fewer than five sub- 
fields, an appropriate number of commas is supplied 
so that the $label card always has the required sub- 
fields and a warning message is printed. 

Each subfield is then checked for length except for 
the last one. Subfields that are longer than the specified 
maximums are truncated to the maximum number of 
characters allowed for each, and a format error 



message is printed. Numeric subfields are also checked 
for validity, and the presence of any nonnumeric char- 
acters causes a format error message to be printed. 



Operation-Defining Pseudo-Operations 

Three pseudo-operations that define symbols as opera- 
tion codes are provided by map. 

The OPD Pseudo-Operation 

The opd ( Operation Definition ) pseudo-operation de- 
fines the symbol appearing in the name field as an 
operation code. The format of the opd pseudo-opera- 
tion is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


OPD 


12-digit octal machine opera- 
tion code definition 



The 12-digit machine operation code definition in the 
variable field must be specified according to the gen- 
eral format given in Appendix C. 

The opd pseudo-operation defines the symbol in the 
name field as an operation code. The symbol must be 
defined by the opd pseudo-operation before its use in 
an operation field. 

For example, 

ALPHA OPD 430106000500 

defines alpha as an operation code having the same 
effect as the machine instruction cla. 

The OPVFD Pseudo-Operation 

The opvfd (Operation Variable Field Definition) 
pseudo-operation defines the symbol in the name field 
as the operation code represented by the expression 
in the variable field. The format of the opvfd pseudo- 
operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


OPVFD 


From 1 to 36 subfields, sep- 
arated by commas 



The format of the variable field is the same as that 
given for the vfd pseudo-operation. The variable field 
expression must result in a 36-bit word having the 
format given in Appendix C. 

The symbol in the name field becomes the mnemonic 
operation code of the instruction. The symbol must be 
defined by opvfd before being used in an operation 
field. 

For example, 

ALPHA OPVFD 06/43,05/00,07/106,06/00, 

012/0500 

defines alpha as an operation code having the same 
effect as the machine instruction cla. 



32 



The OPSYN Pseudo-Operations 

equates the symbol in the name field to the mnemonic 
operation code in the variable field. The format of the 
opsyn pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


OPSYN 


Mnemonic operation code 



The mnemonic operation code in the variable field 

.1 1-1 .• 1/. 1 • -,^ 
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tion code, a pseudo-operation code, a macro-operation 
code, or a code that has been defined previously by 
opd, opvfd, or another opsyn ) . 

If a previously defined operation code is redefined 
with opd, opvfd, or opsyn, a warning message is issued. 
For example, 

CLA OPSYN CAL 

redefines cla as cal. The message warns the program- 
mer of possible inadvertent redefinition of an existing 
operation code. 



Miscellaneous Pseudo-Operations 

The END Pseudo-Operation 

The end pseudo-operation signals the end of the sym- 
bolic deck and terminates assembly. The end operation 
must be present and must be the last card in the sym- 
bolic deck. The format of the end pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

r* nl 1 _ 
Z. DldTlKH 


END 


1. An element, or 

Zi. Dianas 



In a relocatable assembly, the value of the element 
in the variable field is the nominal starting point of the 
program segment. 

The end pseudo-operation performs the following 
functions in an absolute assembly: 

1. Any binary output waiting in the punch buffer is 
written out. 

2. A binary transfer card to which control is trans- 
ferred is produced. It has a transfer address that is the 
value of the expression in the variable field. 

If unpnch is in effect, no cards are punched. 

The ETC Pseudo-Operation 

The variable field of most instructions may be ex- 
tended over additional cards by using the etc pseudo- 
operation. The format of the etc pseudo-operation is : 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Ignored 


ETC 


Subfields, separated by com- 
mas, or partial subfields 



The etc pseudo-operation appends its variable field 
as a continuation of the variable field of the previous 
instruction. The blank that separates the variable field 
from the comments field of a card is an end-of-card 
indicator and not an end-of-variable-field indicator. 
The number of etc cards in one group is generally lim- 
ited by the size of the resultant expression and/or the 
number of subfields. A variable-field expression is lim- 
ited to about 100 elements, operators, and/or subfields. 
No element of an expression may be split between 

■Kxrn narrlc TTnr pyamnlp tnp> inctnipHnn 



TIX 


NAME + 1,4,1 


could be written 




TIX 
ETC 


NAME+1 
,4,1 


or 




TIX 

ETC 

ETC 

ETC 


NAME 
+ 1,4 
5 1 


or 




TIX 
ETC 


NAME + 1,4, 
1 


but could not be written 




TIX 
ETC 


NA 

ME + 1,4,1 



The following operations may not be followed by an 
etc card: 



ABS 


IFT 


ORGCRS 


BCI 


INDEX 


PCC 


DEC 


LABEL 


PCG 


DETAIL 


LBL 


PMC 


DUP 


LDIR 


PUNCH 


EJECT 


LIST 


QUAL 


rnd 


T.ORC 


REM 


ENDM 


NOCRS 


TITLE 


ENDQ 


NULL 


TTL 


EVEN 


OCT 


UNLIST 


FUL 


OPD 


UNPNCH 


IFF 


OPSYN 


USE 



If an etc follows any of these operations except end, 
the etc will be ignored and a low-severity warning 
message issued. 

The REM Pseudo-Operation 

The rem ( Remarks ) pseudo-operation permits remarks 
to be entered into the assembly listing. The format of 
the rem pseudo-operation is: 



NAME FIELD 



Any informa- 
tion 



OPERATION 
FIELD 



REM 



VARIABLE FIELD 



Any information 



The contents of columns 8-10 (the operation field) 
are replaced by blanks, and the remaining contents of 
the card are copied onto the assembly listing. The rem 
pseudo-operation supplements the remarks card that 
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has * in column 1. In a macro-definition, the variable 
field of the rem card is scanned for substitutable pa- 
rameters, whereas the * card causes an error message 
but is otherwise completely ignored. 

The KEEP Pseudo-Operation 

The keep pseudo-operation permits the programmer 
to specify a debugging dictionary that contains only 
those symbols he wishes to use in debug requests. The 
format of the keep pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


KEEP 


One or more symbols ( which 
may not be qualified ) , 
separated by commas 



The symbols in the variable field are entered into 
the debugging dictionary along with any modal and 
dimensional information that was supplied in bss, bes, 
equ, and syn pseudo-operations. Any number of keep 
pseudo-operations may appear in a program. If the 
nodd option was specified on the $ibmap card, the keep 
pseudo-operation is ignored. ( For further information 
concerning debugging and the debugging dictionary, 
see the publications IBM 7090/7094 IBSYS Operating 
System: IBJOB Processor, Form C28-6389, and IBM 
7090/7094 IBSYS Operating System: IBJOB Processor 
Debugging Package, Form C28-6393. ) 



The FUL Pseudo-Operation 

The ful pseudo-operation specifies card output in the 
24-word-per-card "full" mode. The format of the ful 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FTELD 


VARIABLE FIELD 


Blanks 


FUL 


Ignored 



The ful pseudo-operation always causes the next 
output word to start a new card. Any words remaining 
in the punch buffer are written out in the previously 
specified format. Cards produced in the column binary 
full mode contain the first word of output in columns 
1-3; the second, in 4-6; and so on to a maximum of 
24 words per card. No control words or check sums 
are generated by the assembler in full mode. 

The PUNCH and UNPNCH Pseudo-Operations 

The punch and unpnch pseudo-operations cause re- 
sumption and suspension, respectively, of binary card 
punching. The format of the punch and unpnch 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


PUNCH or 
UNPNCH 


Ignored 



Absolute-Assembly Pseudo-Operations 

The pseudo-operations abs, ful, punch, unpnch, and 
tcd are effective in absolute assemblies only. They are 
ignored in a relocatable assembly. 



The ABS Pseudo-Operation 

The abs (Absolute) pseudo-operation specifies card 
output in the standard 22-word-per-card column-binary 
card format. The format of the abs pseudo-operation is : 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


ABS 


Ignored 



Binary cards are normally punched in the abs mode 
unless otherwise specified. The abs pseudo-operation 
always causes the next output word to start a new card. 
Any words remaining in the punch buffer arc written 
out in the previously specified format. 

Column-binary card format is described in the pub- 
lication IBM 7090/7094 IBSYS Operating System: 
IBJOB Processor, Form C28-6389. 



The TCD Pseudo-Operation 

A binary transfer card directs an absolute loader pro- 
gram to stop loading cards and to transfer control to a 
designated location. In most cases, a transfer card is 
required at the end of the binary deck. In absolute 
assemblies, the end pseudo-operation causes a binary 
transfer card to be punched. However, the tcd pseudo- 
operation can cause a transfer card to be produced 
before the end of the binary deck. 

The format of the tcd pseudo-operation is: 



NAME FD2LD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


TCD 


A symbolic expression 



The tcd pseudo-operation performs the following 
two functions : 

1. Any binary output waiting in the punch buffer is 
written out. 

2. A binary transfer card is produced having a trans- 
fer address that is the value of the expression in the 
variable field. See the publication IBM 7090/7094 
IBSYS Operating System: IBJOB Processor, Form C28- 
6389, for a description of the format of a transfer card. 

If unpnch is in effect, no cards are punched. 
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List-Control Pseudo-Operations 

The PCC Pseudo-Operation 

The pcc (Print Control Cards) pseudo-operation has 
the following format: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


PCC 


Either: 

1. ON 

2. OFF 

3. Blanks 

4. Any information 



Unless the unlist pseudo-operation is in effect, pcc 
on causes the listing of the following cards : ttl, title, 

LBL, LIST, INDEX, SPACE, EJECT, DETAIL, PCG, PMC, IFT, 

iff, and goto, and any cards under the scope of the ift, 
iff, and goto pseudo-operations that are not assem- 
bled, pcc off suppresses listing of these cards and is the 
normal mode. The pcc card is always listed unless 
vlsij-iiji is m effect, if the variable neid is ulanK or 
contains anything other than on or off, the current 
setting of the pcc switch is inverted. 

The UNLIST Pseudo-Operation 

The unlist pseudo-operation causes all listing to be 
suspended. The format of the unlist pseudo-operation 
is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


UNLIST 


Ignored 



The unlist pseudo-operation is itself listed unless 
a previous unlist is still in effect. After an unlist, no 
lines are listed by the assembly program until a list 
or end pseudo-operation is encountered. 

The LIST Pseudo-Operation 

The list pseudo-operation causes listing to be re- 
sumed following an unlist. The format of the list 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


LIST 


Ignored 



The list pseudo-operation does not appear in the 
assembly listing unless the mode of pcc is on. 

The TITLE Pseudo-Operation 

The title pseudo-operation abbreviates the assembly 
listing by eliminating certain kinds of information. The 
format of the title pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 

1 


TITLE 


Ignored 



title causes the assembly program to exclude the 
following information from the listing: 

1. Any line that contains octal information except 
the instruction that causes it, i.e., all but the first word 
generated by oct, dec, bci, and vfd 

2. All but the entire first iteration of each instruc- 
tion in the range of a dup 

3. All complex fields in a relocatable assembly 

4. The expansion of save and all but the first three 
instructions in the expansion of call. 



f\ 1 1 iriHfmC iri rrtf- 1 



A title pseudo-operation is effective until the as- 
sembly program encounters a detail operation, title 
is not listed except when the mode of pcc is on. 

The DETAIL Pseudo-Operation 

The detail pseudo-operation causes the listing of 
generated data to be resumed after it has been sus- 
pended by a title pseudo-operation. The format of 
the detail pseudo-operation is: 



NAME FIELD 


OPERATION 
FD2LD 


VARIABLE FIELD 


Blanks 


DETAIL 


Ignored 



The sole effect of the detail operation is to cancel 
the effect of a previous title pseudo-operation. If 
title is not in effect, the detail operation is ignored 
by the assembly program. The detail operation does 
not appear in the assembly listing unless the mode of 
pcc is ON. 

The EJECT Pseudo-Operation 

The eject pseudo-operation causes the next line of the 
listing to appear at the top of a new page. The format 
of the eject pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


EJECT 


Ignored 



The eject pseudo-operation appears in the assembly 
listing only if the mode of pcc is on. 

The SPACE Pseudo-Operation 

The space pseudo-operation permits one or more 
blank lines to be inserted in the assembly listing. The 
format of the space pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


SPACE 


1. A symbolic expression, or 

2. Blanks 



The definition of the expression in the variable field 
determines the number of blank lines in the assembly 
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listing. If the value of the expression is zero or the 
variable field is blank, one blank line appears, space 
itself is listed only if the mode of pcc is on. 

The LBL Pseudo-Operation 

Serialization of a deck normally begins with the first 
four characters of the deck name, which are left- 
justified and filled with trailing zeros. However, 
serialization can be altered by using the lbl pseudo- 
operation. The format of the lbl (Label) pseudo- 
operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


LBL 


One or two subfields, separated 
by a comma : 

1. Up to 8 BCD characters, 
which may or may not be 
followed by a comma if the 
second subfield is not present 

2. The word BEGIN followed 
by a blank or a comma 



lbl causes binary cards to be identified and serialized 
in columns 73-80, as follows : 

1. Serialization begins with the characters appear- 
ing" in the variable field, which is lefr-mstified and 
filled with terminating zeros. 

2. Serialization is incremented by one for each 
card until the rightmost nonnumeric character or the 
seventh character is reached, after which the numeric 
portion recycles to zero. The two leftmost characters 
are regarded as fixed, even though they may be 
numeric. 

For example, if the variable field is coded as id, the 
first card is identified and serialized as idoooooo. 

If the variable field is coded as instro3, serialization 

is as follows : 

INSTB030 
INSTR031 



INSTR999 
INSTR000 



If the begin option is not included, reserialization 
begins with the binary card following the one that is 
currently being punched. Serialization can be altered 
at any point in the program by using additional lbl 
pseudo-operations. 

If the begin option is included, the lbl will be effec- 
tive from the beginning of the program, serializing all 
binary cards, including the sfile and $label cards 
created by ibmap as a result of the corresponding 
pseudo-operations, no matter where the lbl appears 
in the program. If more than one lbl pseudo-operation 
with the begin option is used, only the last one will be 



effective. Any lbl pseudo-operations that do not con- 
tain the begin option are processed normally. 

If the variable field of the lbl currently in effect 
does not end with a comma, the assembly program 
prints the phrase 



BINARY 



CARD 



ID. Number 



at the beginning of each card. If a comma is used to 
terminate the variable field, printing of this phrase is 
suppressed. Printing of this phrase can be reinitiated 
by using an lbl pseudo-operation ending in a blank. 
ibl is listed only if the mode of pcc is on. 

The INDEX Pseudo-Operation 

The index pseudo-operation provides a table of con- 
tents of important locations within an assembly. The 
format of the index pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


INDEX 


Symbols, separated by commas 



The first appearance of an index card causes the 
message 

TABLE OF CONTENTS 

to be listed. Each subfield of an index pseudo-opera- 
tion causes the symbol and its definition to be listed. 
If a virtual symbol is used, its definition will be the 
control section number assigned to the symbol. 

index pseudo-operations may appear anywhere in 
the source program and need not be grouped. The 
listing generated by index pseudo-operations is in- 
serted where the pseudo-operations appear. 

For meaningful commentary, index pseudo-oper- 
ations can be grouped and interspersed with ex- 
planatory remarks cards. 

An index pseudo-operation is not processed if any 
of the following three conditions exist: 

1. It is in a macro-expansion and pmc is off. 

2. It is in the range of a dup pseudo-operation and a 
title pseudo-operation is in effect. 

3. An unlist pseudo-operation is in effect. 
Listing of the index card itself is governed by the 

mode of the pcc switch. 

The variable field of an index pseudo-operation 
cannot be extended by use of the etc pseudo-operation. 

The PMC Pseudo-Operation 

The pmc pseudo-operation causes ( or suppresses ) list- 
ing of the card images generated by macro-instructions 
and by the retubn pseudo-operation. The format of 
the pmc (Print Macro Cards) pseudo-operation is: 
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NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


PMC 


Any one of: 

1. ON 

2. OFF 

3. Blanks 

4. Any information 



on in the variable field causes listing of the card 
images generated by macro-instructions; off, which is 
the normal mode, suppresses such listing. A blank 
variable field or one containing any information other 



The TTL Pseudo-Operation 

The TTL ( Subtitle ) pseudo-operation generates a sub- 
heading in the listing. The format of the ttl pseudo- 
operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


TTL 


A string of BCD characters 
starting in card column 12 



Card columns 13-72 are used in words 4-13 of a 
generated subheading, which will appear on each 
page, ttl also forces a page ejection. 

A subheading may be replaced by the variable field 
of another ttl and may be deleted by a ttl with a 
blank variable field. 

Listing of the ttl card is controlled by the pcc 
pseudo-operation. 

The PCG Pseudo-Operation 

The pcg (Print Control Group) pseudo-operation 
causes listing of the relocatable control bits of each 
assembled word. The format of the pcg pseudo- 
operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


PCG 


Any one of: 

1. ON 

2. OFF 

3. Blanks 

4. An v information 



on in the variable field causes listing and off sup- 
presses listing of the relocatable control bits for each 
assembled word, on is the normal mode. A blank 
variable field or one containing any information other 
than on or off inverts the current setting of the pcg 
switch, pcg is ignored in an absolute assembly. 

pcg is listed if the mode of pcc is on. 



Special Systems Pseudo-Operations 

Users of the map language are provided with a wide 
range of subroutines which are included in the sys- 
tems library. A group of system pseudo-operations 
permits the transfer of control and data between the 
main program and the subroutine. Details about 
specific calling sequences are provided in the publica- 
tions IBM 7090/7094 IBYSY Operating System: IBJOB 
Processor, Form C28-6389 and IBM 7090/7094 Opera- 
ting System: Input/Output Control System, Form 



than on or off inverts the current setting or the pmc C28-6345 
switch. 

etc cards extending the variable field of a macro- 
instruction are listed even if the mode of pmc is off. 

Listing of the pmc card is controlled by the pcc 
pseudo-operation. 



The CALL Pseudo-Operation 

The call pseudo-operation produces the standard 
ibjob subroutine calling sequence. The format of the 
call pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


CALL 


One or more subfields: 

1. Symbol or ** 

2. Calling sequence param- 
eters 

3. Error returns 

4. Identification number 



The first subfield in the variable field must contain 
an unqualified symbol (the name of a subroutine) or 
**. The next subfield contains the parameters of the 
calling sequence ( if any ) , enclosed in parentheses and 
separated by commas. These may be any symbolic ex- 
pression. 

Error returns ( if any ) , separated by commas, occupy 
the next subfield. The last subfield is an identification 
number ( if desired ) , less than 32,768 and delimited by 
apostrophes. If specified, this number appears in the 
calling sequence in place of the assembly line number. 
When an identification number is not specified, the 
assembly line number appears. 

For example, a typical call operation might be 
coded 



LCS 



CALL name(argl,arg2, . . . ,argn) 

ETC retl 5 ret2, . . . ,retn'id' 



where name is the name of a subroutine; argl, arg2, 
. . . , argn are the parameters of the calling sequence; 
retl, ret2, . . . , retn are the error returns; and 'id' is the 
identification number. 

A comma should not precede the left parenthesis, 
follow the right parenthesis, nor precede the id'. 

If the subroutine is part of the program being assem- 
bled, the reference is to the routine in the program. 
However, if the subroutine is not part of the program 
being assembled, the symbol in the first subfield of the 
variable field becomes the external name of the sub- 
routine called. If ** is used, a constant zero becomes 
tile C3.U&KJ. auAjxess. 
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The remaining subfields generate the calling se- 
quence. 

Expansions of the CALL Pseudo-Operation 

The linkage produced by 



in the Linkage Director. The format of the save 
pseudo-operation is: 



LCS 



is 



LCS 



CALL NAME ( PI, . . . ,Pn ) Rl, 

ETC . . . ,Rm'ID' 

TSX NAME,4 

TXI *+2+n+m„n 

PZE ID„Linkage Director 

PZE PI 



PZE Pn 

TRA Rm 



TRA Rl 

where P is a subroutine parameter, R is an error 
return, n is the number of parameters and m is the 
number of error returns. The Linkage Director is a 
location unique for each assembly, and has no associ- 
ated symbol. It may be given a symbolic designation 
using the ldir pseudo-operation. 

The operation 

LCS CALL NAME(P1,P2) 



produces 






LCS 


TSX 
TXI 
PZE 
PZE 
PZE 


NAME,4 

* + 2+2 + 0„2 

Line number„Linkage Director 

PI 

P2 


The statement 




LCS 


CALL 


NAME,R1 


produces 






LCS 


TSX 
TXI 
PZE 
TRA 


NAME,4 

*+2+0 + l„0 

Line number„Linkage Director 

Rl 


The statement 




LCS 


CALL 


NAME 


generates 
LCS 


TSX 
TXI 
PZE 


NAME.4 

* + 2+0+0„0 

Line number„Linkage Director 



The SAVE Pseudo-Operation 

The save pseudo-operation produces the instructions 
necessary to save and restore the index registers and 
indicators, to disable and restore all operative traps, 
to provide error returns used by a subprogram, and 
to store the contents of index register 4 in sysloc and 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


SAVE 


Up to 7 subfields containing 
integers or immediate sym- 
bols and any or all of the 
letters I, D, E 



The order in which the subfields in the variable field 
of the save pseudo-operation are used is not important. 
All subfields are optional. 

As many as 7 numeric subfields may be used to 
specify the index registers that are to be saved and 
restored. Immediate symbols may also be used to 
specify index registers. Any or all index registers may 
be specified in any order. 

Index registers are saved in the order 4, 1, 2, 3, 5, 
6, 7 and are restored in the opposite order. Index reg- 
ister 4 is automatically saved and restored, although 
it may still be specified. 

One of the three remaining subfields is literally the 
character I; another is literally the character D; and 

fho loci- l'c Hfo-rollir fl-io nnorontor TT 
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The presence of I signifies that the sense indicators 
are to be saved and restored. 

The presence of D causes all operative traps to be 
disabled and restored. 

The presence of E generates the instructions neces- 
sary to facilitate use of error returns in the call 
pseudo-operation. 

The contents of index register 4 are stored in the 
Linkage Director each time the save pseudo-operation 
is executed, sysloc is a standard communication loca- 
tion used by all programs loaded under ibldr. If the 
assembly is absolute ( the absmod option is specified ) , 
the symbol sysloc must be defined by the programmer. 

The general form of the save pseudo-operation is: 
locsym SAVE ( Xi, . . . ,X k )I,D,E 



or 



locsym 



SAVE 



Xi, . . . ,X k ,LD,E 



Expansions of the SAVE Pseudo-Operation 

The instruction 

LCS SAVE 2,1,1 

or its equivalent 

LCS SAVE (2,1)1 

specifies that index registers 2 and 1 and the sense 
indicators are to be saved. 
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The expansion is: 



ENikY 



LUS 



LCS 


TXI 


. .0003„0 




AXT 


**,2 




AXT 


** i 


. .0001 


AXT 


** ^ 




LDI 


..0002 + 1 


. .0002 


TRA 
PZE 


1,4 


. .0003 


STI 


..0002 + 1 




SXA 


SYSLOQ4 




SXA 


Linkage Director,4 




SXA 


i\r\r\ i a 

. .WW J.,** 




SXA 


..0001-1,1 




SXA 


..0001-2,2 


The instruction 






LCS 


SAVE 


2 


generates 








ENTRY 


LCS 


LCS 


TXI 


. .0003„0 




AXT 


** o 


. .0001 


AXT 


** 4 


. .0002 


TRA 


1,4 


. .0003 


SXA 


SYSLOC,4 




SXA 


Linkage Director,4 




SXA 


. .0001,4 




SXA 


..0001-1,2 



In the next two examples, the instructions generated 
because of using the letters I, D, or E in the subfield 
of a save pseudo-operation are identified by the ap- 
pearance of the particular letter in the comments field 
of the generated instruction. 

The instruction 



LCS 

anorofo 

LCS 

. .0001 

. .0002 
. .0003 



SAVE 



ENTRY 



2,I,D 



LCS 



TXI 


. .0003„0 


AXT 


**,2 


AXT 


** 4 


LDI 


..0002+1 I 


NZT 


.TRPSW D 


ENB* 


TRAPX D 


TRA 


1,4 


PZE 


I 


XEC 


SYSDSB D 


STI 


..0002 + 1 I 


SXA 


SYSLOC,4 


SXA 


Linkage Director,4 


SXA 


. .0001,4 


SXA 


..0001-1,2 



Locations sysdbs, .trpsw, and .trapx are in the Sys- 
tem Monitor (see the publication IBSYS Operating 
System: System Monitor (IBSYS), Form C28-6248). 
A switch at .trpsw indicates whether enabling is per- 
missible at this time; .trapx gives the address of the 
location that contains the bits for proper enabling. 
(Note that the enabling instruction below refers to 
.trapx indirectly. ) 



The following sequence illustrates the expansion 
that is generated when the E option is specified: 

LCS SAVE (2)I,D,E 

generates 





ENTRY 


LCS 


LCS 


TXI 


. .0003,,** 




LDC 

SXD 

LAC 

TXI 

SXA 

LXA 


LCS,4 E 
*+5,4 E 
. .0001,4 E 

* + 1,4,1 E 

* + l,4 E 
** 4 E 




TXI 

SXA 
AXT 


* + l,4,** E 
. .0002,4 E 
**,2 


. .0001 


AXT 


** 4 




LDI 


..0002 + 1 I 




NZT 


.TRPSW D 




ENB* 


.TRAPX D 


. .0002 


TRA 


** TP 




PZE 


I 


. .0003 


XEC 


SYSDSB D 




STI 


..0002 + 1 I 




SXD 
SXA 
SXA 
SXA 
SXA 


LCS,0 E 
SYSLOQ4 
Linkage Director,4 
. .0001,4 
..0001-1,2 



If the save pseudo-operation has no symbol in the 
name field, a symbol will be generated and an error 
message will be printed. 

The SAVEN Pseudo-Operation 

The saven pseudo-operation produces the instructions 
necessary to save and restore the index registers used 
by a subprogram. The format of the saven pseudo- 
operation is : 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


SAVEN 


Up to 10 subfields 



The saven pseudo-operation is similar to save except 
that the instructions 

ENTRY LCS 

SXA Linkage Direetor,4 

are not generated, saven is generally used when en- 
tering a subroutine from another subroutine without 
destroying the linkage information. If the saven 
pseudo-operation has no symbol in the name field, a 
symbol will be generated and an error message will 
be printed. If the variable field is blank, index register 
4 is saved and restored. 



The RETURN Pseudo-Operation 

The return pseudo-operation is designed for use with 
call and save, making use of the error ( or alternate ) 
returns used in these operations. 
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The format of the return pseudo-operation is: 





OPERATION 




NAME FIELD 


FIELD 


VARIABLE FIELD 


1. A symbol, or 


RETURN 


1 or 2 subfields separated by 


2. Blanks 




a comma: 

1. A symbol, 

2. An integer, a symbol, or 
an immediate symbol 



The first subfield in the variable field of the return 
pseudo-operation is required. It contains the name 
of the associated save pseudo-operation. If the second 
subfield is present, it specifies the particular error 
return. 

The return pseudo-operation often takes the general 
form 

name RETURN locsym,i 

where locsym is the symbolic address of the associated 
save pseudo-operation, and i is the desired error 
return ( i = is the normal return ) . 

The form of the return instruction may vary. For 
example, to specify a particular error return (e.g., 2), 
the instruction 



LOC RETURN LCS,2 

is written, where lcs is the location of the save pseudo- 
operation to be used. The following instructions are 
generated: 
LOC 



AXT 


2,4 


SXD 


LCS,4 


TRA 


LCS + 1 



If the E option of the save or saven pseudo-operation 
is not used, the following form should be used: 

RETURN LCS 
which generates 

TRA LCS+1 

This form should also be used even where the E option 
is specified if the error return is inserted into the dec- 
rement of the save or saven pseudo-operation at 
execution time. 

The variable field of the return pseudo-operation 
may not be left blank, since it results in a tra instruc- 
tion with a blank variable field. The pmc pseudo- 
operation governs the listing of the instructions 
generated by the return pseudo-operation. 
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Part III. The Macro-Operation Facility 



Macro-operations are special types of pseudo-opera- 
tions that provide the map user with a powerful pro- 
gramming tool. After a programmer has defined a 
macro-operation, he can cause a whole sequence of 
instructions to oe caiieG into a ^ro^rarn D^ r coQin*' a 
single instruction. The sequence can be repeated as 
often as desired. Moreover, any field or subfield of 
any instruction in the sequence can be changed each 
time the sequence is repeated. 

Any machine instruction, pseudo-operation, or 
macro-operation can be included in a macro-oper- 
ation. The sequence of instructions generated ( usually 
called a macro-expansion) is an open subroutine. The 
instructions are executed in-iine with the rest 01 tue 
program. 

Two general requirements must be met to take 
advantage of the macro-operation facility. First, the 
macro-operation must be defined by a macro-defini- 
tion. Then, wherever the sequence of instuctions is 
desired in the program, it must be called by a macro- 
instruction. 



Defining Macro-Operations 

A macro-definition provides a name for the macro- 
operation, determines the instructions that will be in- 
cluded in the macro-expansion, and establishes the 
parts of the instructions that are to be variable. 

Three kinds of instructions must be coded to de- 
fine a macro-operation. The first is the macro pseudo- 
operation. (The card containing this instruction is 
sometimes called the macro-definition heading card.) 
Prototype instructions (sometimes called prototype 
card images) immediately follow the macro pseudo- 
operation to establish the instructions that will be 
generated in the macro-expansion. Finally, the endm 
pseudo-operation ends the macro-definition. 

The MACRO Pseudo-Operation 

The macro pseudo-operation establishes the name of 
a macro-operation. The format of the macro pseudo- 
operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


BCD name up 
to 6 characters 
long 


MACRO 


Up to 63 substitutable argu- 
ments (groups of not more 
than 6 characters) separated 
by punctuation characters 



The name in the name field becomes the name of 
the macro-operation that is being defined. This name 
is later used to call the macro-operation and thus, in 

effect, becomes an operation code. Any valid symbol 

1. j •„ 1.1. - c_u „r j.t__ — „ 3~ 

iiici v L*c used in liic najLiie ncm. ui liic mauiu • isculuj- 

operation, or all numeric characters may be used. 
However, six zeros may not be used. 

The name in the name field of a macro pseudo- 
operation may be the same as a symbol used any- 
where in the program, even in this or any other macro- 
operation. However, if this name is the same as any 
other machine operation code, pseudo-operation code, 
or macro-operation code, the operation code is re- 
defined. 

The subfields in the variable field of the macro 
pseudo-operation contain substitutable arguments. 

SUBSTITUTARLE ARGUMENTS IN THE MACRO 
PSEUDO-OPERATION 

Much of the flexibility of the macro-operation facility 
results from the principle of substitutable arguments. 
These subfields in the variable field of the macro 
pseudo-operation are dummy names that will be re- 
placed in the macro-expansion. 

Substitutable arguments permit any field or subfield 
of any instruction to be changed each time the macro- 
operation is called. The programmer can also change 
parts of subfields and even add entire instructions. 

A substitutable argument is from one to six char- 
acters long. Any valid symbol may be used, and the 
name of a substitutable argument may consist of all 
numeric characters. For example, in the macro 
pseudo-operation 



ALPHA 



MACRO ABC, 123 



each of the two groups of three characters in the 
variable field is a substitutable argument. 

No punctuation characters except the period may be 
used as part of a substitutable argument. 

A substitutable argument may be the same as a 
symbol or an operation code, including the operation 
code for this or any other macro-operation. However, 
substitutable arguments should not be identical to 
symbols or operation codes used in the prototype that 
immediately follows unless the symbols or operation 
codes are actually intended to be substitutable argu- 
ments. 
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DELIMITING SUBSTITUTABLE ARGUMENTS IN THE MACRO 
PSEUDO-OPERATION 

Substitutable arguments in the variable field of the 
macro pseudo-operation may be separated by any of 
the following punctuation (special) characters: 

= + -'/(),' 
If parentheses are used, they must be used in pairs. 

The use of these characters permits meaningful 
notation in a macro-definition. For example, 

ALPHA MACRO 23,RATE,TIME,DIST, 

QUSYM 

could also be written 

ALPHA MACRO 23(RATE*TIME = DIST) 

QUSYM 

The variable field of the macro pseudo-operation 
may be extended over more than one card by using the 
etc pseudo-operation. When the substitutable argu- 
ments appear on more than one card, the blank char- 
acter acts as a separator. Hence, no punctuation char- 
acter is needed between consecutive substitutable 
arguments that appear on separate cards. For example, 

BETA MACRO 

pmilrl al<:r> V»p written 



A,B,C 



BETA 



MACRO 
ETC 



A,B 
C 



This usage of the etc pseudo-operation differs from 
the usual case, in which all punctuation characters 
must be written. 

Consecutive punctuation characters or an explicit 
zero are ignored and do not result in a substitutable 
argument of zero. 

Prototypes in Macro-Definitions 

The prototype of a macro-definition determines the 
instructions that will be included in the macro-expan- 
sion, their sequence in the expansion, and the positions 
of the substitutable portions of the instructions. The 
prototype, which consists of one or more prototype 
instructions, immediately follows the macro pseudo- 
operation. 

A prototype instruction is similar to any other in- 
struction. It has a name field, an operation field, and 
a variable field. It may also have a comments field, 
although this field does not appear in the card image 
generated in the macro-expansion. The distinguishing 
feature of a prototype instruction is that parts of it can 
be made variable. 

The fields or subfields of a prototype instruction may 
contain text or substitutable arguments. 

TEXT IN PROTOTYPES 

Text represents the fixed parts of the instructions that 
will be generated in the macro-expansion. Any part of 



a prototype instruction that has not been made a sub- 
stitutable argument by its appearance in the variable 
field of the macro pseudo-operation is treated as text. 
For example, in the prototype 



ALPHA MACRO A,B 

CLA A 

B BUFFER 



the operation code cla and the location buffer are 
text, (buffer has been defined elsewhere in the 
program. ) 

Text is reproduced in the macro-expansion exactly 
as it appears in the prototype instruction. Thus, if only 
text is used in a field of an instruction, it must con- 
form to the rules governing that field of the instruc- 
tion in which it is used. For example, if the oper- 
ation field of a prototype instruction is text, it must 
be a valid operation code. 

Since parentheses can be used to delimit substi- 
tutable arguments within the prototype, parentheses 
must be used carefully as part of text to avoid con- 
fusing the enclosed characters with a substitutable 
argument. 

— o 

SUBSTITUTABLE ARGUMENTS IN PROTOTYPES 

Substitutable arguments represent the variable parts 
of the instructions that will be generated in the macro- 
expansion. The same substitutable arguments are used 
in the prototype that appeared in the variable field of 
the macro pseudo-operation. However, in the proto- 
type, substitutable arguments appear in the fields or 
subfields of the prototype instructions that are to be 
variable. A substitutable argument may appear in any 
field or subfield of a prototype instruction. For ex- 
ample, in the sequence. 



BETA 
ONE 



MACRO ONE,TWO,THREE 

CLA PARTI 

TWO PART2 

STO THREE 



one, two, and three are substitutable arguments in 
the name, operation, and variable fields, respectively, 
of prototype instructions. 

DELIMITING SUBSTITUTABLE ARGUMENTS IN PROTOTYPES 

The same punctuation (special) characters may be 
used in prototype instructions that were used to sep- 
arate the substitutable arguments in the variable field 
of the macro pseudo-operation. Except for the apos- 
trophe, these characters are reproduced in the macro- 
expansion. Only the aspostrophe may be used to delimit 
substitutable arguments in the variable fields of rem 
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and ttl pseudo-operations and the data subfields of bci 
pseudo-operations, (Another use of the apostrophe in 
macro-operations is explained in the section "Com- 
bining Substitutable Arguments and Text.") 

A comma or a left parenthesis immediately follow- 
ing the operation code (as near the beginning of the 
card as column 11) signifies the end of the operation 
field and the beginning of the variable field. 

A blank delimits a substitutable argument in a pro- 
totype. For example, in the macro-definition (where 



K ronrocgnk £1 blank ' 



XYZ 



MACRO 
AbbbB 



A,B,C 



three blanks separate A (in the operation field) from 
B (in the variable field). It is not always necessary 
that three blanks separate these two fields, but at 
least three characters are used for an operation field 
code. In this example, A and two blanks are used, 
whereas the third blank is required to terminate the 
operation field. If fewer blanks separated A from B, 
both would be taken as part of the operation code, 
causing errors. 

If a blank is encountered before card column 72 
in the variable field of a prototype instruction other than 
a bci, rem, or ttl pseudo-operation, the card is termi- 
nated. Substitutable arguments may appear anywhere 
from column 1 through column 72 on bci, rem, and 
ttl cards. Any information to the right of the blank will 
not be included in the macro-definition. 

Every field or subfield of six or fewer characters in 
any field of a prototype instruction is compared with 
the substitutable arguments in the variable field of 
the macro pseudo-operation. Therefore, care must be 
taken to avoid confusing fields intended as text with 
fields intended as substitutable arguments. 

Cards with an asterisk (*) in column 1 (remarks 
cards ) may be interspersed with macro-definition cards 
but will not be included in the macro-expansion. 

The EN DM Pseudo-Operation 

The endm pseudo-operation terminates a macro- 
definition. The format of the endm pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


ENDM 


Either: 

1. One or two subfields, sep- 
arated by a comma, or 

2. Blanks 



The endm pseudo-operation immediately follows the 
last prototype instruction and ends the macro-defini- 
tion. An endm pseudo-operation is required for every 
macro pseudo-operation. 



The first of the two subfields permitted in the 
variable field of the endm pseudo-operation is a bcd 
name of up to six characters. If a name is used in this 
subfield, it must be the same as the name used for the 
corresponding macro pseudo-operation. If the first 
subfield is not used, but the second is, a comma must 
precede the second subfield. 

If the second subfield in the variable field of the 
endm pseudo-operation is present, it specifies either 
crs (create symbols) or nocrs (no created symbols). 
The second subfield controls symbol creation for this 
macro-operation only, overriding the effect of the 
nocrs and orgcrs pseudo-operations (see the section 
"Created Symbols" ) . crs in this subfield always causes 
and nocrs always suppresses symbol creation each 
time the macro-operation is called. Any symbol other 
than crs or nocrs has no effect. 

For example, in the macro-definition 

ALPHA 



MACRO 


A,B 


CLA 


A 


ADD 


B 


STO 


SUM 


ENDM 


ALPHA,NOCRS 



the endm pseudo-operation is coded so that symbol 
creation is suppressed whenever this macro-operation 
is called. 

If the variable field or the first subfield of the 
variable field is blank, this and all unterminated macro- 
definitions are terminated (see the section "Nested 
Macro-Operations" ) . 



Calling Macro-Operations 

After a macro-operation has been defined, it may be 
called so that the generated sequence of instructions 
is brought into a program at a desired point. In the 
macro-expansion, each prototype instruction in the 
macro-definition is reproduced. Text and all punctua- 
tion characters except the apostrophe are reproduced 
exactly as they appeared in the prototype. However, 
the substitutable arguments that appeared in the varia- 
ble field of the macro pseudo-operation and in the 
prototype are replaced by the actual parameters that 
the programmer wishes to appear in the expansion. 
These parameters are provided in the macro-instruc- 
tion, which is used to call the macro-operation. 

The Macro-Instruction 

The macro-instruction calls a previously defined 
macro-operation into a program. The format of the 
macro-instruction is : 
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NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


Macro- 
operation 
name 


Parameters, separated by com- 
mas or enclosed in parentheses. 



FIRST 



If there is a symbol in the name field, it is assigned to 
the first instruction of the macro-expansion. 

The name that was assigned in the name field of the 
macro pseudo-operation is an operation code and is 
used in the operation field of the macro-instruction. 

The variable field of the macro-instruction contains 
the actual parameters that the programmer wishes to 
appear in the macro-expansion. 

PARAMETERS IN MACRO-INSTRUCTIONS 

The parameters in the variable field of the macro- 
instruction replace the substitutable arguments that 
appeared in the macro-definition. These parameters 
must appear in the same order as the substitutable 
arguments they are to replace originally appeared in 
the variable field of the macro pseudo-operation. 

The length of a parameter in the variable field of a 
macro-instruction is not limited to six characters as is a 
substitutable argument. The variable field of a macro- 
instruction may be extended over more than one card 
by using the etc pseudo-operation. However, a single 
parameter must appear completely on one card unless 
it is enclosed in parentheses. 

Macro-instruction parameters consist of any appro- 
priate character or group of characters that would 
normally appear in the particular instruction. For ex- 
ample, in the macro-definition. 



QPOLY 
LOOP 


MACRO 

AXT 

LDQ 

FMP 


COEFF,LOOP,DEG,T, 

DEG,T 

COEFF 

GAMMA 




OP 
XCA 


COEFF+DEG+1/T 




TIX 
ENDM 


LOOP,T,l 
QPOLY 



mnemonic symbols represent the substitutable argu- 
ments, loop appears in a name field, op in an operation 
field, and coeff, dec, and T appear in subfields of the 
variable field, gamma is text and not a substitutable 
argument, since it does not appear in the variable field 
of the macro pseudo-operation. In this macro-instruc- 
tion, a symbol should be substituted for loop and a 
valid operation code for op. Such a macro-instruction 
might be written 



X015 



QPOLY CI - 4,FIRST,5,4,FAD 



The macro-expansion would cause the following 
six card images to be generated. 



X015 



AXT 
LDQ 



5,4 
Cl-4 



FMP 
FAD 
XCA 
TIX 



GAMMA 

Cl-4 + 5 + 1,4 

FIRST,4,1 



The symbol xois is assigned to the first instruction, 
and each substitutable argument is replaced by the 
corresponding parameter that appeared in the variable 
field of the macro-instruction. 

DELIMITING MACRO-INSTRUCTION PARAMETERS 

The parameters in the variable field of a macro- 
instruction are separated either by commas or paren- 
theses. A single comma following a right parenthesis 
or preceding a left parenthesis is redundant and may 
be omitted. Neither of these combinations results in a 
null parameter. A null parameter is indicated by two 
consecutive commas or by a single comma at the be- 
ginning of the variable field. If the blank terminating 
the variable field is preceded by a comma, the last 
subfield is not null (see the example in the section 
"Created Symbols"). An explicit zero must be used to 
obtain a zero parameter. 

Parentheses around data used as a macro-instruction 
parameter signify that everything within the paren- 
theses, including blanks, is to replace the correspond- 
ing substitutable argument in the prototype. ( In fact, 
if blanks are to be included in a macro-instruction 
parameter, the parameter must be enclosed in paren- 
theses. ) For example, the macro-definition 



XYZ 
B 



MACRO 

A 



A,B 
ENDM XYZ 



followed by the macro-instruction 



XYZ 

ETC 



results in the expansion 



ALPHA 



AXT 
TRA 



(AXTbbbbblO,l) 

( ALPHAbbTRAbbbbbBETA,!) 



10,1 
BETA,1 



If parentheses are to appear in a macro-expansion, 
they must be enclosed in an outer pair of parentheses. 
The outer parentheses are removed in the expansion. 

Pairs of parentheses must be balanced. For example, 
given the macro-definition 



CALLIO 


MACRO 


IOCOM,Tl,OP,LABEL,T2 




ETC 


TAPNO,PFX,ERRET 




TSX 


(TAPE), 4 




PZE 


IOCOM,Tl,OP 




PZE 


LABEL,T2,TAPNO 




IFT 


ERRET=1 




PFX 


ERRET 




ENDM 


CALLIO 



and using the following parameters in place of the 
substitutable arguments 



44 



IOCOM - CITIO 
Tl-2 

OP-(RBEP) 
LABEL - CITLB 



T2 - null 

TAPNO - CITTAP 
PFX - null 
ERRET - null 



the corresponding macro-instruction would be 

CALLIO CITIO,2, ( ( RBEP ) ) ,CITLB 
ETC ,CITTAP„, 

This macro-instruction could also be written 

CALLIO CITIO,2 ( ( RBEP ) ) CITLB 
ETC 3 CITTAP„, 



SJUHJO 



Note that tape must not be a substitutable argument 
and that (rbep) must be enclosed in outer parentheses. 
Also, an explicitly null parameter appears in the macro- 
instruction at a position corresponding to the substi- 
tutable argument erret in the macro-definition. This 
null parameter causes the fifth word of the expansion 
to be omitted. 

Inserting Instructions into Macro-Expansions 

A single parameter in a macro-instruction may include 
more than one field or even an entire instruction to 
replace a single substitutable argument that appeared 
in a field of a prototype instruction. The parameter is 
inserted into the field in which the original substituta- 
ble argument appeared, and it may extend to other 
fields to the right of the field in which it is inserted. 
For example, if a substitutable argument appeared in 
the operation field of a prototype instruction, a parame- 
ter could be inserted that would have an operation 
field and a variable field. 

When a parameter consists of more than one field 
or is an entire instruction, the programmer must pro- 
vide enough blanks in the parameter so that the fields 
of the instruction appear in their proper positions in 
the macro-expansion. 

In the following example, a substitutable argument 
in the operation field of a prototype instruction is re- 
placed by an instruction having an operation field and 
a variable field. The macro-definition. 

XYZ MACRO A,B,C, 

CLA A 
B 

STO C 

ENDM XYZ 

followed by the macro-instruction 

SUM 



XYZ 
ETC 



ALPHA ( ADDbbbbbBETA ) 
GAMMA 



results in the macro-expansion 



CLA 
ADD 
STO 



ALPHA 

BETA 

GAMMA 



Conditional Assembly in Macro-Operations 

The ift and iff pseudo-operations may be used to de- 



termine whether instructions within a macro-expansion 
are assembled. For example, the sequence 



MACRO 


B,C,D 


CLA 


B 


ADD 


C 


IFF 


/D/=/AC/ 


STO 


D 



ADDM 



allows the sum to be stored if the name substituted for 
D is not literally the characters ac and prevents it 
from being stored if the name is the characters ac. 

If the iff pseudo-operation in the above example 
were replaced by 



IFT 



D = l 



the sum would be stored only if the parameter substi- 
tuted had already appeared in the name field of some 
instruction (i.e., if the S- value of D is 1). 

The two conditions can be combined to obtain 



IFF 
IFT 



/D/ = /AC/,AND 
D = l 



which assembles the store operation only if D is not 
literally ac and has appeared before in a name field. 

Combining Substitutable Arguments and Text 

The apostrophe can be used to combine substitutable 
arguments and text to form a single prototype subfield. 
The apostrophe delimits a substitutable argument in a 
macro-definition prototype but is not itself included in 
the macro-expansion. However, the apostrophe may not 
be used to combine partial subfields in lower-level 
nested macro-definitions (see the section "Nested 
Macro-Operations" ) . 

For example, given the macro-definition 



ALPHA 



MACRO 
BCI 



ENDM 



A,B,C 

A,bb'B'bERROR,b 
CONDITION'C'b 
IGNORED 
ALPHA,NOCRS 



the macro-instruction 



ALPHA 6, (FIELD),, 

causes the following instruction to be generated: 

BCI 6,bbFIELDbERROR,b 

CONDITIONb 

IGNORED 

By using the apostrophe, instructions within macro- 
operations can be altered and even name field symbols 
can be changed. For example, the macro-definition 

FXCY MACRO B,W,Z,Y,T 

N'B PXA Y,T 

PAC 0,4 

¥X"Z Y,4 

ENDM FXCY 

after the macro-instruction 

FXCY AME,S,A,DATA,i 
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results in the sequence 



PXA 


DATA,1 


PAC 


0,4 


SXA 


DATA,4 



NAME 



The name field may not exceed six characters in the 
prototype, including substitutable arguments, text, and 
punctuation characters. The operation field may not 
exceed six characters or six characters and an asterisk. 

Nested Macro-Operations 

A macro-definition may be included completely within 
the prototype of another higher-level macro-definition. 
When the higher-level macro-operation is expanded, 
the macro pseudo-operation and the prototype of the 
lower-level macro-operation are generated. Thus, a 
macro-instruction for a lower-level macro-operation 
cannot be used until all higher-level macro-operations 
have been expanded. 

A new macro-operation may be defined or an existing 
macro-operation redefined, depending on whether the 
name of the lower-level macro-operation appears as text 
or as a substitutable argument in the higher-level 
macro-operation. For example, in the macro-definition 

MAC1 MACRO MAC2,ALPHA,BETA 

ETC GAMMA,DELTA 

MAC2 MACRO ALPHA 

BETA A 

GAMMA B 

DELTA C 

ENDM MAC2 

ENDM MAC1 

the lower-level macro-operation, mac2, appears as a 

substitutable argument. The macro-instruction 

MAC1 ABC,(A,B,C),CLA,ADD,STO 

generates 

ABC MACRO A,B,C 

CLA A 

ADD B 

STO C 

ENDM ABC 

which defines a macro-operation, abc, where A, B, and 
C are substitutable arguments; and cla, add, and sto 
are text. 

However, had mac2 appeared. as text rather than as a 
substitutable argument in the macro-definition of maci, 
mac2 would be redefined each time maci was ex- 
panded. 

There is no significant limit to the depth of nesting 
permitted. 

Macro-Instructions in Macro-Definitions 

The prototype of a macro-definition may include 
macro-instructions for which macro-operations have 
not yet been defined. However, these macro-instruc- 
tions must be defined before using a macro-instruction 



that expands the macro-operation. Care must be ex- 
ercised to avoid a macro-definition loop. For example, 
if macro-operation A contains an unconditional call 
on macro-operation A (a macro-instruction for A), a 
macro-definition loop will result. However, if the call 
on macro-operation A is conditional (i.e., there is pro- 
vision for eventual exit from the loop), a macro-oper- 
ation A may contain a macro-instruction for A. 

Data enclosed within parentheses may be used as a 
parameter in a macro-instruction. When a macro- 
instruction is used within another macro-definition, 
special handling of data containing blanks is required. 
Such data must be replaced by a substitutable argu- 
ment in the outer macro-definition. The actual data 
must appear as a parameter in the macro-instruction. 
An additional pair of parentheses must surround the 
data (already within a single pair of parentheses) to 
ensure proper substitution. 

For example, in the macro-definition 

MACI 



MACRO 


A,C 


CLA 


C 


MAC 


A,(AXTbb**,4b) 


STO 


A 


ENDM 


MACI 



mac is a previously defined macro-operation. Proper 
substitution would not occur, because a blank termi- 
nates the variable fields of prototype instructions except 
for the bci, rem, and ttl pseudo-operations. Instead, 
the following sequence should be used: 

MACI MACRO A,C,D 

CLA C 

MAC A,D 

STO A 

ENDM MACI 

When using the macro-instruction maci, the substitu- 
tion would be 

MACI X,Y, ( ( AXTbb**,4b ) ) 

The resulting generated sequence is 



CLA 


Y 


MAC 


X,(AXTbb**,4b) 


STO 


X 



The macro-instruction for mac can now cause the data 
to be substituted properly. 

Qualification Within Macro-Operations 

The qualification in effect when the macro-instruction 
is used will be used for symbols in the macro-expansion. 
If a qualification symbol is required within a macro- 
definition, it may be a substitutable argument, as may 
the symbols it qualifies. 

If a macro-expansion having a qualified section falls 
within the range of a qualified section in the program, 
the rules for nested qualification apply when referring 
to symbols within the macro-expansion. 
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Macro-Related Pseudo-Operations 

The irp pseudo-operation is used to supplement the 
definition of macro-operations, whereas orgcrs and 
nocrs are used in macro-expansions. 



The IRP Pseudo-Operation 

The irp ( Indefinite Repeat ) pseudo-operation causes a 
sequence of instructions within a macro-operation to be 
repeated with one parameter varied at each repetition. 
The format of the irp Dseudo-ooeration is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


IRP 


1. A single substitutable argu- 
ment, or 

2. Blanks 



To repeat a sequence of instructions, two irp pseudo- 
operations are required within a macro-definition — one 
to initiate the sequence and the other to end it. A single 
substitutable argument that originally appeared in the 
variable field of the preceding macro pseudo-operation 
must appear in the variable field of the initial irp 
pseudo-operation. The variable field of the second irp 
pseudo-operation is left blank. 
For example, the operation 

IRP A 

initiates a sequence, whereas 
IRP 

ends the sequence. 

Substitutable argument A governs the iteration of the 
instructions. If a symbol other than a single substitu- 
table argument or more than one subfield appears in 
the variable field of the first irp pseudo-operation, the 
pseudo-operation is ignored and a warning message is 
issued. 

In the macro-instruction, substitutable argument A 
is replaced by one or more subarguments enclosed in 
parentheses and separated by commas. Each time the 
macro-instruction is used, the assembly program gener- 
ates the sequence of instructions with each of the sub- 
arguments used successively in place of suitable 
argument A. If only one subargument is used, the 
sequence of instructions will be generated only once. 
If no subarguments are given, the whole sequence will 
be skipped. If a blank appears within the parentheses, 
only the arguments to the left of the blank will be effec- 
tive. For example, given the macro-definition 



XYZ 



MACRO ARG,B 

IRP ARG 

CLA ARG 

ADD B 

STO ARG 

IRP 

ENDM XYZ 



the macro-instruction 



generates 



XYZ 


(J.K.L), CONST 


CLA 


J ) 


ADD 


CONST > (First iteration, with 


STO 


J j subargument J) 


CLA 


K I 


ADD 


CONST > (Second iteration, with 


STO 


K j subargument K) 


CLA 


L / 


ADD 


CONST V (Third iteration, with 


STO 


L I subarerument L) 



If the substitutable argument does not appear be- 
tween the two irp pseudo-operations, the generated 
sequences will be identical, their number depending on 
the number of subarguments given. 

For example, given the macro-definition 



BBB 



MACRO 


C,D,E 


IRP 


C 


CLA 


D 


STO 


E 


IRP 




ENDM 


BBB 



the macro-instruction 



generates 



BBB 



CLA 
STO 
CLA 
STO 
CLA 

STO 



( 1,2,3 ),DATA1,DATA2 



DATA1 
DATA2 
DATA1 
DATA2 
DATA1 
DATA2 



An irp pseudo-operation may not occur explicitly 
within the range of another irp. Such a nested pair 
causes termination of the first range and opening of a 
second range. However, a macro-instruction within the 
range of an irp pseudo-operation may itself cause pairs 
of irp pseudo-operations to be generated at a lower 
level. 

Created Symbols 

If parameters are missing from the end of the variable 

field of the macro-instruction, symbols are created to 

fill the vacancies. These symbols take the form 

..0001 
..0002 



No created symbols are supplied for an explicitly null 
argument. Created symbols are supplied only at the end 
of the parameters. 

For example, if the macro pseudo-operation 

ALPHA MACRO A,B,C 

is followed by the macro-instruction 
ALPHA X„ 
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substitutable argument A is replaced by X, substitu- 
table argument B is omitted since the parameter is ex- 
plicitly void, and substitutable argument C is replaced 
by a symbol of the form . . nnnn. This symbol is created 
to replace the omitted parameter at the end of the 
variable field of the macro-instruction. 
Given the macro-definition 



XFAD 



MACRO N,B,C,D,E,A,X 





SXA 


A,4 




AXT 


N,4 


X 


CLA 


B,4 




IFF 


/C/ = // 




F'G 


D,4 




STO 


E,4 




TIX 


X,4,l 


A 


AXT 


** A 




ENDM 


XFAD,CRS 


the macro 


-instruction 






XFAD 


4,DATA,AD,DAT 


generates 








SXA 


..0001,4 




AXT 


4,4 


..0002 


CLA 


DATA,4 




FAD 


DATA1,4 




STO 


DATA2,4 




TIX 


..0002,4,1 


..0001 


AXT 


** A 


However 


the macro-instrL 


..ction 




XFAD 


4,DATA,„DATA2 


generates 








SXA 


..0001,4 




AXT 


4,4 


..0002 


CLA 


DATA,4 




STO 


DATA2,4 




TIX 


..0002,4,1 


..0001 


AXT 


** A 



In this example, the number of instructions can vary 
between references, making a relative-address refer- 
ence difficult. However, by permitting the assembly 
program to generate the names, the references are cor- 
rect without requiring programmer-specified names. 

The NOCRS Pseudo-Operation 

The nocrs pseudo-operation suppresses symbol crea- 
tion, which causes missing parameters at the end of the 
variable field of the macro-instruction to be treated as 
if they were explicitly null. The format of the noces 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


NOCRS 


Ignored 



The ORGCRS Pseudo-Operation 

The orgcrs pseudo-operation may be used to alter the 
form of created symbols. This pseudo-operation also 
causes symbol creation to be resumed if it has been 
suppressed by a nocrs. The format of the orgcrs 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


ORGCRS 


1. Blanks, or 

2. Up to 4 numeric digits, or 

3. One BCD character and 
up to 4 numeric digits. 



If a ecd character appears in the variable field, it re- 
places the second period of the created symbols. If dig- 
its appear, they will be the origin of the new set of 
created symbols. This origin will be one lower than the 
first symbol actually created. If fewer than four digits 
are used, they will be right-justified with leading zeros. 
If no digits are supplied or if the variable field is blank, 
the number will continue from the last created symbol. 

With a blank variable field, the orgcrs pseudo-opera- 
tion causes resumption or continuation of symbol 



V^A VyCl IX \JXX, 



The PURGE Pseudo-Operation 

The purge pseudo-operation removes from core stor- 
age prototypes of macro-operations that are no longer 
needed, thus providing space for other prototypes. 
However, the purge pseudo-operation does not remove 
the name of the macro-operation from the name table. 
The format of the purge pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


PURGE 


A list of macro-operation names, 
separated by commas 



If an entry in the variable field of a purge pseudo- 
operation is not the name of a macro-operation, it is 
ignored and no message is issued. 

If a macro-operation is redefined, purging of the 
previous form is automatic ( a purge pseudo-operation 
is not needed ) . 

If a call is made to a purged macro-operation, the 
call will be ignored and an error message will be issued. 
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Appendixes 



Appendix A: Machine Operations 

All machine operations recognized by map are tabu- 
lated in this appendix, including supplementary infor- 
mation about their format and use. Listings are pro- 
vided of the 7090 machine operations, extended 
machine operations, special operations, 7094 machine 
operations, 7909 data channel commands, 1301 disk file 
orders, and 7340 Hypertape orders. 

The code letters used under identical column head- 
ings have the same significance in all tables. The bcd 
name of the machine operation is given in the column 
headed Mnemonic. 

Type indicates machine-instruction format character- 
istics by code letters having the following meanings: 



CODE 


MEANING 


A 


15-bit decrement field 


B 


No decrement field 


C 


8-bit decrement field 


D 


18-bit address field 


E 


13-bit address field 


K 


4-bit prefix field 


L 


Disk orders 



The codes in the address ( Addr ) , tag, and decrement 
(Deer) columns signify: 

CODE MEANING 

R Subfield required. If missing, error message 

FIELD REQUIRED is issued. 

P Subfield permitted. Neither its presence nor 

absence results in a message. 
U(n) Subfield unexpected. If present, message FIELD 

NOT EXPECTED is issued. Assembly program 
truncates definition value of subfield to number 
of bits (n) shown in parentheses and, treating 
this value as a constant, adds it to value nor- 
mally appearing in subfield. 

N Subfield not allowed. If present and its value 

is not zero, message FIELD NOT ALLOWED 
is issued. Its value is always treated as a con- 
stant zero. 

If the size of a subfield differs from normal, field size is 
indicated in parentheses following the subfield letter 
code. 

In the column headed Ind, the letter (P) indicates 
that indirect addressing is permitted and ( N ) indicates 
that is is not permitted. 

7090 Machine Operations 



MNEMONIC 


TYPE 


ADDR 


TAG 


DECR 


IND 


ACL 


B 


R 


P 


U(4) 


P 


ADD 


B 


R 


P 


U(4) 


P 


ADM 


B 


R 


P 


U(4) 


P 


ALS 


B 


R 


P 


U(6) 


N 


ANA 


B 


R 


P 


U(4) 


P 


ANS 


B 


it 


P 


U(4) 


P 



MNEMONIC 


TYPE 


ADDR 


TAG 


DECR 


IND 


ARS 


B 


R 


P 


U(6) 


N 


AXC 


B 


R 


R 


U(6) 


N 


AXT 


B 


R 


R 


U(6) 


N 


BSF 


B 


R 


P 


U(6) 


N 


BSR 


B 


R 


P 


U(6) 


N 


BTT 


E 


R 


P 


U(6) 


N 


CAL 


B 


R 


P 


U(4) 


P 


CAQ 


C 


R 


P 


R(8) 


N 


CAS 


B 


R 


P 


U(4) 


P 


CHS 


E 


N 


P 


U(6) 


N 


CLA 


B 


R 


P 


U(4) 


P 


CLM 


E 


N 


P 


U(6) 


N 


CLS 


B 


R 


P 


U(4) 


P 


COM 


E 


N 


P 


U(6) 


N 


CRQ 


C 


R 


P 


R(8) 


N 


CVR 


C 


R 


P 


R(8) 


N 


DCT 


E 


N 


P 


V(6) 


N 


DVH 


B 


R 


P 


U(4) 


P 


DVP 


B 


R 


P 


U(4) 


P 


ECTM 


E 


N 


P 


U(6) 


N 


EFTM 


E 


N 


P 


U(6) 


N 


ENB 


B 


R 


P 


U(4) 


P 


ENK 


E 


N 


P 


U(6) 


N 


ERA 


B 


R 


P 


U(4) 


P 


ESNT 


B 


R 


P 


U(4) 


P 


ESTM 


E 


N 


P 


U(6) 


N 


ETM 


E 


N 


P 


U(6) 


N 


ETT 


E 


R 


P 


U(6) 


N 


FAD 


B 


R 


P 


U(4) 


P 


FAM 


B 


R 


P 


U(4) 


P 


FDH 


B 


R 


P 


U(4) 


P 


FDP 


B 


R 


P 


U(4) 


P 


FMP 


B 


R 


P 


U(4) 


P 


FRN 


E 


N 


P 


U(6) 


N 


FSB 


B 


R 


P 


U(4) 


P 


FSM 


B 


R 


P 


U(4) 


P 


HPR 


B 


P 


P 


U(6) 


N 


HTR 


B 


R 


P 


U(4) 


P 


IIA 


B 


P 


P 


U(6) 


N 


HL 


D 


R(18) 


N 


U(6) 


N 


IIR 


D 


R(18) 


N 


U(6) 


N 


IIS 


B 


R 


P 


U(4) 


P 


IOT 


E 


N 


P 


U(6) 


N 


IOCD 


A 


R 


N 


R 


P 


IOCP 


A 


R 


N 


R 


P 


IORP 


A 


R 


N 


R 


P 


IOCT 


A 


R 


N 


R 


P 


IORT 


A 


R 


N 


R 


P 


IOSP 


A 


R 


N 


R 


P 


IOST 


A 


R 


N 


R 


P 


LAC 


B 


R 


R 


U(6) 


N 


LAS 


B 


R 


P 


U(4) 


P 


LBT 


E 


N 


P 


U(6) 


N 


LCHx 


B 


R 


P 


U(4) 


P 


LDC 


B 


R 


R 


U(6) 


N 


LDI 


B 


R 


P 


U(4) 


P 


LDQ 


B 


R 


P 


U(4) 


P 


LFT 


D 


R(18) 


N 


U(6) 


N 


LFTM 


E 


N 


P 


U(6) 


N 


LGL 


B 


R 


P 


U(6) 


N 


LGR 


B 


R 


P 


U(6) 


N 


LLS 


B 


R 


P 


U(6) 


N 


LNT 


D 


R(18) 


N 


U(6) 


N 


LRS 


B 


R 


P 


U(6) 


N 
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MNEMONIC 

LSNM 

LTM 

LXA 

LXD 

MPR 

MPY 

MSE 

NOP 

NZT 

OAI 

OFT 

ONT 

ORA 

ORS 

OSI 

PAC 

PAI 

PAX 

PBT 

PDC 

PDX 

PIA 

PSE 

PXA 

PXD 

RCHx 

RCT 

RDCx 

RDS 

REW 

RFT 

RIA 

RIL 

RIR 

RIS 

RND 

RNT 

RQL 

RUN 

SBM 

SCHx 

SDN 

SIL 

SIR 

SLQ 

SLW 

SSM 

SSP 

STA 

STD 

STI 

STL 

STO 

STP 

STQ 

STR 

STT 

STZ 

SUB 

SXA 

SXD 

TCH 

TCNx 

TCOx 

TEFx 

TIF 

TIO 

TIX 

TLQ 

TMI 

TNO 

TNX 



TYPE 
E 
E 

B 

B 

B 

B 

E 

B 

B 

B 

B 

B 

B 

B 

B 

B 

B 

B 

E 

B 

B 

B 

E 

B 

B 

B 

E 

E 

B 

B 

D 

B 

D 

D 

B 

E 

D 

B 

B 

B 

B 

B 

D 

D 

B 

B 

E 

E 

B 

B 

B 

B 

B 

B 

B 

A 

B 

B 

B 

B 

B 

A 

B 

B 

B 

B 

B 

A 

B 

B 

B 

A 



ADDR 

N 

N 

R 

R 

R 

R 

R 

P 

R 

P 

R 

R 

R 

R 

R 

P 

P 

P 

N 

P 

P 

P 

R 

P 

P 

R 

N 

N 

R 

R 

R(18) 

P 

R(18) 

R(18) 

R 

N 

R(18) 

R 

R 

R 

R 

R 

R(18) 

R(18) 

R 

R 

N 

N 

R 

R 

R 

R 

R 

R 

R 

P 

R 

R 

R 

R 

R 

R 

R 

R 

R 

R 

R 

R 

R 

R 

R 

R 



TAG 
P 
P 
R 

R 

P 

P 

P 

P 

P 

P 

P 

P 

P 

P 

P 

R 

P 

R 

P 

R 

R 

P 

P 

R 

R 

P 

P 

P 

P 

P 

N 

P 

N 

N 

P 

P 

N 

P 

P 

P 

P 

P 

N 

N 

P 

P 

P 

P 

P 

P 

P 

P 

P 

P 

P 

P 

P 

P 

P 

R 

R 

N 

P 

P 

P 

P 

P 

R 

P 

P 

P 

R 



DECR 
U 



IND 

N 

N 

N 

N 

P 

P 

N 

N 

P 

N 

P 

P 

P 

P 

P 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

P 

N 

N 

N 

N 

N 

N 

N 

N 

P 

N 

N 

N 

N 

P 

P 

N 

N 

N 

P 

P 

N 

N 

P 

P 

P 

P 

P 

P 

P 

N 

P 

P 

P 

N 

N 

P 

P 

P 

P 

P 

P 

N 

P 

P 

P 

N 



MNEMONIC 


TYPE 


ADDR 


TAG 


DECR 


IND 


TNZ 


B 


R 


P 


U(4) 


P 


TOV 


B 


R 


P 


U(4) 


P 


TPL 


B 


R 


P 


U(4) 


P 


TQO 


B 


R 


P 


U(4) 


P 


TQP 


B 


R 


P 


U(4) 


P 


TRA 


B 


R 


P 


U(4) 


P 


TRCx 


B 


R 


P 


U(4) 


P 


TSX 


B 


R 


R 


U(6) 


N 


TTR 


B 


R 


P 


U(4) 


P 


TXH 


A 


R 


R 


R 


N 


TXI 


A 


R 


R 


R 


N 


TXL 


A 


R 


R 


R 


N 


TZE 


B 


R 


P 


U(4) 


P 


UAM 


B 


R 


P 


U(4) 


P 


UFA 


B 


R 


P 


U(4) 


P 


UFM 


B 


R 


P 


U(4) 


P 


UFS 


B 


R 


P 


U(4) 


P 


USM 


B 


R 


P 


U(4) 


P 


VDH 


C 


R 


P 


R(6) 


P 


VDP 


C 


R 


P 


R(6) 


P 


VLM 


C 


R 


P 


R(6) 


P 


WEF 


B 


R 


P 


U(6) 


N 


WRS 


B 


R 


P 


U(6) 


N 


XCA 


B 


P 


P 


U(6) 


N 


XCL 


B 


P 


P 


U(6) 


N 


XEC 


B 


R 


P 


U(4) 


P 


ZET 


B 


R 


P 


U(4) 


P 



Extended Operations 

map provides a group of sense and select-type extended 
operation codes for programmer convenience. These 
codes permit the address portion of certain instructions 
to be specified symbolically as part of the operation 
code, rather than octally in the address portion of the 
instruction. These codes also provide more meaningful 
mnemonics for some machine instructions. 

map also recognizes a group of prefix codes that can 
be used in such programming applications as forming 
constants or in subroutine calling sequences. 

SENSE TYPE 

The following extended operation codes of the sense 
type are recognized by the assembly program. The tag 
subfield is permitted in all these operation codes, but 
indirect addressing is not permitted in any of them. 
The letter x is to be replaced by one of the channel 
letters. 



MNEMONIC 

BTTx 

ETTx 

SLF 

SLN 

SLT 

SPRx 

SPTx 

SPUx 

SWT 

SELECT TYPE 



ADDR 

N 
N 
N 
R 
R 
R 
N 
R 
R 



U(6) 
U(6) 
U(6) 
U(6) 
U(6) 
U(6) 
U(6) 
U(6) 
U(6) 



The following extended operation codes of the select 
type are recognized by the assembly program. The tag 
subfield is permitted in all these operation codes, but 
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indirect addressing is not permitted in any of them. 
If the following instructions are used in a relocatable 
deck, the address field must contain an integer or an 
immediate symbol. The letter x is to be replaced by a 
channel letter. 



MNEMONIC 


ADDR 


DECR 


BSRx 


R 


U(6) 


BSFx 


R 


U(6) 


RCDx 


N 


U(6) 


REWx 


R 


U(6) 


RPRx 


N 


U(6) 


RTBx 


R 


U(6) 


■DTT"*.. 


T) 


TT/ Q \ 


JL\ J. UA 


r\ 


\J \ O } 


RUNx 


R 


U(6) 


SDHx 


R 


U(6) 


SDLx 


R 


U(6) 


WEFx 


R 


U(6) 


WPBx 


N 


U(6) 


WPDx 


N 


U(6) 


WPUx 


N 


U(6) 


WTBx 


R 


U(6) 


WTDx 


R 


U(6) 


PREFIX CODES 







The following prefix codes are recognized by the as- 
sembly program. All have 15-bit decrement fields 
(Type A) with address, tag, and decrement permis- 
sible. Indirect addressing is permitted for all prefix 
codes. 



MNEMONIC 


MEANING 


PREFIX 


FIVE 


Five 


5 


FOR 


Four 


4 


FOUR 


Four 


4 


FVE 


Five 


5 


MON 


Minus One 


5 


MTH 


Minus Three 


7 


Mi w 


Minus Two 


6 


MZE 


Minus Zero 


4 


ONE 


One 


1 


PON 


Plus One 


1 


PTH 


Plus Three 


3 


PTW 


Plus Two 


2 


rZE 


Plus Zero 





SEVEN 


Seven 


7 


SIX 


Six 


6 


SVN 


Seven 


7 


THREE 


Three 


3 


TWO 


Two 


2 


ZERO 


Zero 






Special Operations 

The following special operations recognized by map 
reduce coding effort for frequently occurring condi- 
tions. Indirect addressing is not permitted in any of 
these operations. 



MNEMONIC TYPE 



BFT 
BNT 
BRA 



IIB 

RIB 

SIB 

ZAC 

ZSA 



D 
D 
A 
A 
A 
A 
D 
D 
D 
B 
B 
B 



TAG 

N 
N 
N 
P 
P 
P 
N 
N 
N 
N 
N 



DECR 

N 

N 

P 

P 

P 

P 

N 

N 

N 

U(6) 

U(6) 

U(6) 



ASSEMBLES 
AS 

LFT(RFT) 

LNT(RNT) 

TXL 

PZE 

PZE 

PZE 

IIL(IIR) 

RIL(RIR) 

SIL(SIR) 

PXD 

SXA 



(See the section "The rbool and lbool Pseudo- 
Operations" for a description of special type D in- 
structions. ) 

7094 Machine Operations 

The following 7094 machine operations are recognized 
by map. In a 7090 assembly, these operations are re- 
placed by system macro-instructions (see Appendix 
B ) with the exceptions noted below. The 7090 system 
macro-instructions closely approximate the effects of 
tne /uy4 machine operations but may cause slight 
differences in the precision of the results obtained. 

If a subfield is to be supplied at execution time, the 
notation ** must be used. The field may not be left 
blank. 



MNEMONIC 


TYPE 


ADDR 


TAG 


DECR 


IND 


DFAD 


B 


R 


P 


U(4 


) P 


DFAM 


B 


R 


P 


U(4 


) P 


DFDH 


B 


R 


P 


U(4 


) P 


DFDP 


B 


R 


P 


U(4 


) P 


DFMP 


B 


R 


P 


U(4 


) P 


DFSB 


B 


R 


P 


U(4 


) P 


DFSM 


B 


R 


P 


U(4 


) P 


DLD 


B 


R 


P 


U(4 


) P 


DST 


B 


R 


P 


U(4 


P 


*DUAM 


B 


R 


P 


U(4 


P 


*DUFA 


B 


R 


P 


U(4 


P 


*DUFM 


B 


R 


P 


U(4] 


P 


*DUFS 


B 


R 


P 


U(4 


P 


*DUSM 


B 


R 


P 


U(4 


P 


*EMTM 


E 


N 


P 


U(6 


N 


*LMTM 


E 


N 


P 


u(6; 


N 


PCA 


B 


P 


R 


U(6) 


N 


PCD 


B 


P 


R 


U(6) 


N 


SCA 


B 


R 


R 


U(6) 


N 


SCD 


B 


R 


R 


U(6) 


N 



These 7094 instructions are not replaced by macro-instructions 
when assembling in the 7090 mode; they are assembled as 
NOP instructions, and a low-severity message is issued, 

IBM 7909 Data Channel Commands 

The following 7909 data channel commands are recog- 
nized by the assembly program. An x in the operation 
code is to be replaced by a channel letter. 



MNEMONIC 

CPYD 

CPYP 

CTL 

GTLR 

CTLW 
(l)ICC 

LAR 

LCC 

LIP 

LIPT 

RICx 

RSCx 

SAR 

SCDx 

SMS 

SNS 

STCx 
(l)TCM 

tDc 



TYPE 

A 
A 

K 
K 
K 
K 
K 
K 
K 
A 
E 
B 
K 
B 
K 
K 
B 
K 
K 



ADDR 
R 
R 

R 
R 
R 
P 
R 
R 

13 

J. 

R 

N 
R 
R 
R 
R 
P 
P 
R 
K 



TAG 

N 
N 
N 
N 
N 
N 
N 
N 
N 
N 
P 
P 
N 
P 
N 
N 
P 
N 
N 



DECR 
R 

R 

N 

N 

N 

N 

N 

N 

N 

U(4) 

U(6) 

U(4) 

N 

U(4) 

N 

N 

U(4) 

R 

N 



IND 
P 
P 
P 
P 
P 

N 
P 
P 
N 
P 
N 
P 
P 
P 
P 
N 
P 
P 
}? 



Appendix 51 



MNEMONIC 


TYPE 


ADDR 


TAG 


DECR 


IND 


TWT 


K 


R 


N 


N 


P 


WTR 


A 


R 


N 


U(4) 


P 


XMT 


A 


R 


N 


R 


P 



( 1 ) A count field in the high-order position of the decrement 
is assembled from the fourth subfield of the variable field. 
For example, 

ICC ,„4 



IBM 1301 Disk and 7320 Drum File Orders 

The following disk and drum file orders are recog- 
nized by map. The symbolic order should be written: 

Location DORD access and module, track, record 

and assembles as ten bcd digits in two successive loca- 
tions. 





ACCESS AND 






MNEMONIC 


MODULE 


TRACK 


RECORD 


DEBM 


P 


P 


P 


DNOP 


P 


P 


P 


DREL 


P 


P 


P 


DSAI 


P 


P 


P 


DSBM 


P 


P 


P 


DSEK 


P 


P 


P 


DVCY 


P 


P 


P 


DVHA 


P 


P 


P 


DVSR 


P 


P 


P 


DVTA 


P 


P 


P 


DVTN 


P 


P 


P 


DWRC 


P 


P 


P 


DWRF 


P 


P 


P 



The access/module and track subfields may be any 
symbolic expression. They are evaluated in the normal 
manner and converted to bcd. The low-order two char- 
acters of the access/module subfield and the low-order 
four characters of the track subfield are inserted into 
the instruction. The record subfield is taken as alpha- 
meric data, and the first two characters are used. A 
dnop ( 1212 8 ) order is inserted in the last two charac- 
ter positions of the second word. 

IBM 7340 Hypertape Orders 

The following Hypertape orders are recognized by 
map. The symbolic order should be written: 

Location HORD Tape unit ( if required ) 

and assembles as two ( or three for hsbr and hsel ) bcd 
characters, left-justified in the word. Locations contain- 
ing two-character oiders are filled with trailing hnop 
( 1212 8 ) codes. Three-character orders are repeated in 
the rightmost three characters. 



MNEMONIC 


TAPE UNIT 


HBSF 


N 


HBSR 


N 


HCCR 


N 


HCHC 


N 


HCLN 


N 


HEOS 


N 


HERG 


N 


HFPN 


N 


HNOP 


N 



MNEMONIC 


TAPE UNIT 


HRLF 


N 


HRLN 


N 


HRUN 


N 


HRWD 


N 


HSBR 


R 


HSEL 


R 


HSKF 


N 


HSKR 


N 


HUNL 


N 


HWTM 


N 



Any symbolic expression may be used in the tape unit 
subfield. The expression is evaluated and converted to 
bcd, and the low-order character is used as the Hyper- 
tape unit number ( 0-9 ) . 



Appendix B: 7090 Macro-Expansions of 7094 
Instructions 

When assembling in the 7090 mode, certain 7094 in- 
structions are replaced by equivalent 7090 macro- 
instructions. The expansions of these macro-instructions 
are provided in this appendix. 

The expansions are divided into groups in which only 
a few instructions vary from the given operation code. 

X 111/ t^V/lll/J. IVs llia^l U'1/A UailOlUll \JX 1/CL\-/XA E»lV/U.Jk/ JLO £lV\sl.± 

with the necessary substitutions. 

In this appendix, the symbols e.i, e.2, e.3, and e.4 
are generated by the expansions as names of temporary 
storage locations. However, these symbols must be de- 
fined by the programmer or they will be virtual. The 
symbol is generated and defined by the expansion even 
if the mode of the created symbol switch is nocbs. 

Relative addressing must be used carefully when 
7090 macro-expansions of 7094 instructions are used. 
The reason for this, of course, is that the single macro- 
instruction appearing in the source program will be 
replaced by a group of 7090 instructions during 
assembly. 

For example, at first glance the following sequence 
of instructions appears to be a loop that will form 
five, double-precision, floating-point products, where 

1. the first factor of each product is composed of the 
contents of location alpha + i and beta + i ( i = 0,1,2,3,4 ) , 

2. the second factor is composed of the contents 
of locations mult and mult + 1, 

3. each product replaces its first factor in storage, 
and 

4. multiplication does not occur if the contents of 
alpha + i are negative. 



XXX 



AXT 


5,2 


CLA 


ALPHA + 5,2 


LDQ 


BETA + 5,2 


TMI 


XXX + 3 


DFMP 


MULT 


STO 


ALPHA + 5,2 


STQ 


BETA +5,2 


TIX 


*-6,2,l 
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However, since the macro-instruction dfmp will be 
replaced by a macro-ex n ansion consistin 0, of 12 in- 
structions (see below), the tmi and tix instructions 
in this sequence would both cause transfers to some 
"unknown" instruction in the macro-expansion. 
Similarly, the sequence 



DFop 



*,T 



SCD 
TXL 



* 1,2 
NAME.4.** 



would result in an error since the *1 indicates an in- 
struction in the macro-expansion of the scd instead of 



lih_, j.aj_i man uwuun as uncnucu. 



When assembling in the 7094 or 7094 n mode, the 
macro-operations listed in this section are automati- 
cally purged. 

Group l.PCA and PCD 
For pca, take w = A 
For pcd, take w = D 

The expansion is then 

PCw Y,T 





PXw 
PwC 

PXw 
PwC 


Y,T 
,T 
,T 
,T 


Group 2. SCA and SCD 
For sca, take w = A. 






For scd, take w = D. 






The expansion is then 






SCw Y,T 


SXA 
AXG 
SXw 
LXA 


* + l,T 

** T 

Y,T 

*-2,T 



Group 3. DFAD, DFSB, DFAM, and DESM 
For dfad, take op = ad. 
For dfsb, take op = sb. 
For dfam, take op = am. 
For dfsm, take op = sm. 

In this and the following groups, the expansion below 
is also used: 



(SAVE 



Y,T 



DFop 
or DFop 



DFop* 



CRS 

Y,T 



CRS 



NOP 


,T 


STQ 


E.l 


Fop* 


*-2 


STO 


E.2 


TXI 


* + l,T,-l 


XCA 




FAD 


E.l 


Fop* 


*-7 


FAD 


E.2 


TXI 


* + l,T s l 


AXT 


,0 


OV A 


/-TOO * 


o^vrv 


\jy.\j,^± 


LAC 


*-2,4 


DFop 


0,4 


AXT 


A 


(SAVE 


Y,T 


CLA 


E.l 


DFop 


0,4 


AXT 


,4 



Group 4. DLDandDST 
For dld, take op = ld, opa = cla, and opb = ldq. 
For dst, take op = st, opa = sto, and opb = stq. 
There are four forms for these expansions: 



Dop 
Dop 



Dop - 
or Dop 



Dop" 



Y,T 



>.T 



\0 



Y,T 



CRS 



opa 


Y,T 


opb 


Y + l/T 


opa 


,T 


TXI 


• + 1.T.-1 


opb* 


*~2 


TXI 


* + l,T,l 


opa 





SXA 


*+3,4 


LAC 


*-2,4 


opb 


1,4 


AXT 


,4 


(SAVE 


Y,T 


IFT 


/opa/ = /STO/ 


CLA 


E.l 


opa 


0,4 


opb 


1,4 


AXT 


** 4 



NOP 


Y,T 


STO 


E.l 


CLA* 


*-2 


STA 


*+2 


STT 


* + l 


PXA 


,0 


SUB 


*-l 


SXA 


CRS,4 


PAC 


0,4 


CLA 


E.l 



Group 5. DFMP 

There are four forms for this expansion: 



DFMP 



Y,T 



There are four forms for these expansions: 
DFop Y,T 



STQ 

Fop 

STO 

XCA 

FAD 

Fop 

FAD 



E.l 
Y,T 

E.2 

E.l 

Y+l/T 

E.2 



DFMP 



\T 



STO 


E.l 


FMP 


Y,T 


STO 


E.2 


LDQ 


Y,T 


FMP 


E.l 


STQ 


E.3 


STO 


E.4 


LDQ 


Y+l/T 


FMP 


E.l 


FAD 


E.2 


FAD 


E.3 


FAD 


E.4 


NOP 


** ^ 


STO 


E.i 


FMP* 


*-2 
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DFMP 
or DFMP 



DFMP* 



** 
**,0 



CRS 
Y,T 

CRS 



STO 


E.2 


LDQ* 


*_4 


FMP 


E.l 


STQ 


E.3 


STO 


E.4 


TXI 


* + l,T,-l 


LDQ* 


*-9 


TXI 


* + l,T,l 


FMP 


E.l 


FAD 


E.2 


FAD 


E.3 


FAD 


E.4 


AXT 


**,0 


SXA 


CRS 


LAC 


*-2,4 


DFMP 


0,4 


AXT 


** A 


(SAVE 


Y,T 


CLA 


E.l 


DFMP 


0,4 


AXT 


** A 



Group 6. DFDPandDFDH 
For dfdp, take w = P. 
For dfdh, take w = H. 

There are four forms for these expansions: 



DFDw 



Y,T 



DFDw 



*,T 



DFDw 
or DFDw 



DFDw* 



** 

** Q 



CRS 
Y,T 

CRS 



STQ 


E.l 


FDw 


Y,T 


STO 


E.2 


STQ 


E.3 


FMP 


Y+l/T 


CHS 




FAD 


E.2 


FAD 


E.l 


FDw 


Y,T 


XCA 




FAD 


E.3 


NOP 


,T 


STQ 


E.l 


FDw* 


*-2 


STO 


E.2 


STQ 


E.3 


TXI 


* + l,T,-l 


FMP* 


*-6 


CHS 




FAD 


E.2 


FAD 


E.l 


TXI 


* + l,T,l 


FDw* 


*-ll 


XCA 




FAD 


E.3 


AXT 


**,0 


SXA 


CRS,4 


LAC 


•-2,4 


DFDw 


0,4 


AXT 


** 4 


(SAVE 


Y,T 


CLA 


E.l 


DFDw 


0,4 


AXT 


** 4 



Appendix C: Operation Code Formats 

The operation code formats to be used with the opd 
and opvfd pseudo-operations are given in this ap- 
pendix. 

Operations 

Entries are made in the Combined Operations Table 
for all opd and opvfd pseudo-operations, since the 
lookup process is the same as for any other symbol. To 
specify machine operations using opvfd, the general 
form of this entry is 

6/ A,5/0, 1 /IND,2/ADD,2 /TAG,2/DEC,18/V 
where each group of bits in the instruction word is 
specified by an octal number. The same general form 
is used for opd except that the 36-bit word is specified 
as a whole by a 12-digit octal number that will result 
in the same bit structure. 

In this format, V varies with adjective code A (de- 
scribed below). The fields add, tag, and dec refer to 
address, tag, and decrement, respectively. The follow- 
ing code is used: 

Field required 

1 Field permissible 

2 Field unexpected but allowed 

3 Field not permissible 

A 1 for ind indicates that indirect addressing is per- 
mitted, and a indicates that it is not permitted. 

The seven bits specifying fields ind, add, tag, and 
dec are denoted by fr ( Fields Required ) . 

Pseudo-Operations 

The general form of the entry for pseudo-operations 
in the Combined Operations Table is 

06/A, 12/N, 18/0 
where A is the adjective code and N defines a specific 
pseudo-operation under that adjective code. 

The single exception is the macro call (adjective 
code 62). The format for this entry is 

06/62, 12/C, 3/SC, 15/L 
where c is the number of parameters, sc is symbol 
creation information, and l is the location of the in- 
ternal prototype. Adjective 62 is not allowed with opd 
and opvfd pseudo-operations. 

Adjective Codes 

The following list of octal adjective codes gives the 
type of operation to which each applies. 



CODE (OCTAL) 


OPERATION TYPE 


40 


A 


41 


Prefix or Modified Type B 


42 


Input/Output Command 


43 


B 


44 


C 


45 


D 



54 



CODE (OCTAL) 


OPERATION TYPE 


46 


E 


47 


Select 


50 


Disk and Drum Channel Commands 




(4 fields) 


51 


Disk and Drum Channel Commands 


52 


Boolean Variable 


53 


Disk File and Drum File Orders 


54 


Unexpanded 7094 Instructions 


55 


Hypertape Orders 


*56 


Special Internal Code 


*57 


Special Internal Code 


CODE (OCTAL) 


PSEUDO-OPERATION TYPE 


60 


Macro Definition 


61 


Macro Related 


*62 


Macro Call 


63 


Location 


64 


Storage Allocation 


65 


Decimal Symbol Definition 


66 


Boolean Symbol Definition 


67 


Operation Defining 


70 


Dup and Skipping 


71 


Data Generating 


72 


Nongenerative 


73 


Absolute Assembly 


*74 


Commentary 


75 


Miscellaneous 


76 


Special System 


77 


List Control and Debug 



"This adjective code is not usable with OPD and OPVFD 
pseudo operations. 

TYPE A INSTRUCTIONS ( 40 ) 

The entry is 

O6/40,O5/0,O7/FR,O6/0,O12/OPCODE 
where opcode is an octal machine code written with the 
prefix in the first digit. For example, opcode for the in- 
struction txi would be 1000. 

prefix operations ( 41 ) 
This entry is 

O6/41,O5/0,O7/FR,O6/0,O12/OPCODE 
where opcode is written with the prefix in the first digit. 
For example, opcode for the instruction pon would be 
1000. 

MODIFIED type B INSTRUCTIONS ( 41 ) 

The entry is 

O6/41,O5/0,O7/FR,O3/0,O3/D,O12/OPCODE 
where opcode is written with the prefix in the first digit 
and D is a six or seven that is part of the machine code. 
For example, opcode for the 7040/7044 instruction 
msm (Make Storage Sign Minus) would be 5623, and 
D would be 6. (The pseudo-operations in the form 
shown above can be used to assemble 7040/7044 sign 
position handling instructions. See Appendix F. ) 

INPUT/OUTPUT COMMANDS ( 42 ) 

The entry is 

O6/42,O5/0,O7/FR,O3/N,O3/0,O12/OPCODE 
where opcode is written with the prefix in the first digit. 
For example, opcode for the instruction tch would be 



1000. If the instruction is a nontransmitting command, 

N = 2. 

TYPE B INSTRUCTIONS ( 43 ) 

The entry is 

O6/43,O5/0,O7/FR,O6/0,O12/OPCODE 
TYPE C INSTRUCTIONS ( 44 ) 

The entry is 

O6/44,O5/0,O7/FR,O6/0,O12/OPCODE 
TYPE D LNSTRUCTIONS ( 45 ) 

The entry is 

O6/45,O5/0,O7/FR,O6/0,O12/OPCODE 
TYPE E INSTRUCTIONS ( 46 ) 

The usual format is 

O6/46,O5/0,O7/FR,O3/S,O15/EA 
where S is the sign of the operation: 

If S = 0, opcode would be + 0760. 

If S = 1, opcode would be -0760. 
ea is the actual extended address of the instruction. 

SELECT INSTRUCTIONS ( 47 ) 

The entry is 

O6/47,O5/0,O7/FR,O3/0,O3/E,O6/C,O6/OPCODE 
opcode is the Select type, as follows: 

= Read 

1 = Write 

2 = Set Density High 

3 = Set Density Low 

4 = Rewind 

5 = Rewind Unload 

6 = Backspace Record 

7 = Backspace File 
10 = WriteEndof File 

C is the channel number of Select, starting at 1 for 
Channel A. 

E is the equipment code and has the following signi- 
ficance: 

= Decimal Tape 

1 = Binary Tape; or either Binary or Decimal Tape 

2 = Card Reader 

3 = Punch 

4 = Decimal Printer 

5 = Binary Printer 

See "Select Type" operations for specific address 
field requirements. 

DISK AND DRUM CHANNEL COMMANDS ( 50 ) 

The entry is 

O6/50 5 O5/0,O7/FR,O6/0,O12/OPCODE 
DISK AND DRUM CHANNEL COMMANDS ( 51 ) 

The entry is 

O6/51,O5/0,O7/FR,O3/N,O3/0,O12/OPCODE 
where X = 2 if a 1 in bit position 19 is part of the 
operation code. 
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BOOLEAN VARIABLE ( 52 ) 

The entry is 

O6/52,O5/0,O7/FR,O6/0,O12/OPCODE 
where the high-order bit of opcode is always on. 

DISK FILE AND DRUM FILE ORDERS ( 53 ) 

The format is 

O6/53,O6/0,O2/ACC,O2/TRK,O2/REC, 
O6/0,O12/ORCODE 

orcode is the order, written in external bcd notation. 
For example, drel with an order code of 04 would be 
written 1204. 

The fields acc, trk, and rec refer to the access 
module, track, and record, respectively. Encoding is: 

1 Field permissible 

UNEXPANDED 7094 INSTRUCTIONS ( 54 ) 

The entry is 

O6/54,O5/0,O7/FR,O6/0,O12/OPCODE 
HYPERTAPE ORDERS ( 55 ) 

The entry is 

O6/55,O6/0,O2/ADD,O10/0,O12/OPCODE 
The following is a list of pseudo-operations cor- 
responding to specific A's and N's. 



A 


N 


PSEUDO-OPERATION 


60 





MACRO 


61 





IFT 




1 


IFF 




2 


IRP 




3 


SET 




4 


ORGCRS 




5 


NOCRS 




6 


ENDM 


63 





USE 




1 


BEGIN 




2 


ORG 




3 


LOC 


64 





BSS 




1 


BES 




2 


COMMON 




3 


EVEN 




4 


LORG 




5 


LDIR 




6 


LITORG 


65 





EQU (andSYN) 




1 


MAX 




2 


MIN 


66 





BOOL 




1 


LBOOL 




2 


RBOOL 


67 





OPD 




1 


OPVFD 




2 


OPSYN 


70 





DUP 




1 


GOTO 


71 





OCT 




1 


DEC 




2 


BCI 




3 


LIT 




4 


VFD 



A 


N 


PSEUDO-OPERATION 


72 





QUAL 




1 


ENDQ 




2 


CONTRL 




3 


FILE 




4 


ENTRY 




5 


LABEL 


73 





ABS 




1 


FUL 




2 


TCD 




3 


PUNCH 




4 


UNPNCH 


75 





ETC 




1 


REM 




2 


NULL 




3 


END 




4 


PURGE 


76 





CALL 




1 


SAVE 




2 


SAVEN 


77 





UNLIST 




1 


LIST 




2 


TITLE 




3 


DETAIL 




4 


EJECT 




5 


SPACE 




6 


LBL 




7 


PCC 




8 


INDEX 




9 


PMC 




10 


TTL 




11 


PCG 




12 


KEEP 



Appendix D: IBMAP-FAP Incompatibilities 

This appendix lists the incompatibilities that will occur 
when assembling a fap or ibsfap program using ibmap. 

1. All fap machine operations and extended ma- 
chine operations will assemble properly in map. 

2. All fap pseudo-operations pertaining to the up- 
date facility have no counterpart in map. They are: 

DELETE NUMBER UMC 

ENDFIL REWIND UNLOAD 

ENDUP SKIPTO UPDATE 

IGNORE SKPFIL 

3. The following fap pseudo-operations have no 
counterpart in map. (Since map treats undefined op- 
erations as remarks, some of these operations do not 
affect assembly.) 



IFEOF 
PRINT 
SST 



TAPENO 

704 
9LP 



4. The following fap pseudo-operations must be 
replaced by the indicated map equivalent: 



FAP 

HEAD,HED 
BCD 
MOP 
MAC 

END (of macro) 
RMT 



MAP 

QUAL,ENDQ 

BCI 

MACRO 

Standard macro-instruction 

ENDM 

USE and USE PREVIOUS 



( Note that qual permits nesting of qualifiers, whereas 
head does not.) 
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The following is an example of a program segment 
coded first in fap and then in map. 



RMT 

BSS 

RMT 



10 



ALPHA 



RMT * 

EXTERN 

SKP 

SPC 

TSX $SUB,4 



USE 
BSS 
USE 



BEGIN 

Leave 

symbols 

undefined 

ETECT 

SPACE 

TSX 



RMT 

10 

PREVIOUS 



RMT, ALPHA 



SUB,4 (remove all $ signs that 
specify external names) 



5. The following pseudo-operations have identical 
names in fap and map but differ in context or meaning: 

IFF 

The meaning of the mnemonic and, therefore, the con- 
tents of the variable field, differ. 

COxMMON 

COMMON counter increments forward in MAP. 



DUP 



N 



In MAP, the S-value of symbolic instruction and iteration 
counts is used. Therefore, a FAP sequence such as 



EQU 
DUP 



5 
1,N 



must be changed in MAP, to 

N SET 5 

DUP 1,N 

Also, in MAP, a symbol placed in the name field of a 
card within the range of a DUP is duplicated along with 
the rest of the card. 

EQU,SYN 

In MAP, these apply to symbol definitions only and 
cannot be used where an S-value is required; see DUP 
above. 

OPD.OPVFD 

The variable field should correspond to the MAP diction- 
ary entry format (see Appendix C). 



MACRO 

In MAP, this is used as 
NAME MACRO A 5 B,C,.. S 

and may not be used as 

MACRO 

NAME A,B,C,... 

LOC 

In MAP, the expression 

LOC blank 

is meaningless. The effect of a LOC is terminated with 
the ORG pseudo-operation. 

NULL 

In MAP, a symbol in the name field of the card will be 
given the value of the current location counter, 

CALL 

In MAP, the arguments must be enclosed in parentheses. 
Also, a different calling sequence is generated. 

SET 

In MAP, the S-value of symbols in the variable field is 
used. 

6. The following fap pseudo-operations have their 

equivalent option specified on the sibmap card: 

REF 
7090 
COUNT 
SST 

7. In map, the null pseudo-operation rather than 
equ * should be used for symbol definition, because of 
the limited size of the Pseudo-Operation Dictionary. 

8. The following fap pseudo-operations will as- 
semble properly in map: 



ABS 


FULL 


ORGCRS 


BCI 


INDEX 


PCC 


BES 


LBL 


PMC 


BOOL 


LIST 


REM 


BSS 


MAX 


SPACE 


DEC 


MIN 


TCD 


DETAIL 


NOCRS 


TITLE 


EJECT 


OCT 


UNLIST 


ENTRY 


OPSYN 


TTL 


ETC 


ORG 


VFD 



9. In map, virtual entries in the Control Dictionary 
correspond to the transfer vector of fap except that 
ibldr provides direct rather than indirect references. 

10. In map, normal arithmetic truncates to 15 bits 
in the address field, 3 in the tag, and as specified in 
the decrement, vfd symbolic arithmetic truncates to 
a maximum of 20 bits. Boolean arithmetic truncates to 
18 bits. 

11. Literals are placed in the literal pool in the 
order in which they appear in a program; they are not 
arranged numerically. 
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Appendix E: The MAP BCD Character Code 

The map bcd character code is shown in octal form in 
in the following table with the corresponding ibm 
punched card code. 



CHARACTER 


BCD CODE ( OCTAL ) 


CARD CODE 


(blank) 


60 


(blank) 





00 





1 


01 


1 


2 


02 


2 


3 


03 


3 


4 


04 


4 


5 


05 


5 


6 


06 


6 


7 


07 


7 


8 


10 


8 


9 


11 


9 


A 


21 


12-1 


B 


22 


12-2 


C 


23 


12-3 


D 


24 


12-4 


E 


25 


12-5 


F 


26 


12-6 


G 


27 


12-7 


H 


30 


12-8 


I 


31 


12-9 


J 


41 


11-1 


K 


42 


11-2 


L 


43 


11-3 


M 


44 


11-4 


N 


45 


11-5 


O 


46 


11-6 


P 


47 


11-7 


Q 


50 


11-8 


R 


51 


11-9 


S 


62 


0-2 


T 


63 


0-3 


U 


64 


0-4 


V 


65 


0-5 


W 


66 


0-6 


X 


67 


0-7 


Y 


70 


0-8 


Z 


71 


0-9 


+ (plus) 


20 


12 


— ( minus ) 


40 


11 


/ (slash) 


61 


0-1 


= ( equals ) 


13 


8-3 


( apostrophe ) 


14 


8-4 


( period ) 


33 


12-8-3 


) (right parenthesis) 


34 


12-8-4 


$ ( dollar sign ) 


53 


11-8-3 


* (asterisk) 


54 


11-8-4 


, (comma) 


73 


0-8-3 


( ( left parenthesis ) 


74 


0-8-4 



Appendix F: Assembly of 7040/7044 
Programs on a 7090/7094 

A 7040/7044 object deck may be obtained by assem- 
bling a 7040/7044 map Language source deck on the 
7090/7094. Most 7040/7044 instructions are identical 
to those on the 7090/7094, so that no changes or addi- 



tions must be made to ensure their proper assembly. 
Some 7040/7044 instructions, however, must be de- 
fined using an opvfd or opd pseudo-operation, and 
others require definition as macro-instructions. 

The 7040/7044 instructions which are compatible 
with those on the 7090/7094 are listed in the "Systems 
Compatibility" section of the publication IBM 7040/ 
7044 Principles of Operation, Form A22-6649. The 
7040/7044 double-precision floating-point instructions 
will be assembled directly or expanded as macro- 
instructions, depending on whether M94 or M90 is speci- 
fied on the sibmap card. 

The following 7040/7044 instructions must be de- 
fined with an opd or opvfd pseudo-operation: 

1. An instruction (except an str) with the 12-bit 
operation code — lxxx and no part of the operation 
code in the address field. 

2. The Sign Position Handling instructions. 

3. The Character Handling operations. 

4. The Data Transmission instructions. 

5. The Memory Protect instructions. 

6. The Direct Data Connection instructions. 

For example, the variable field of the opvfd or opd 

■nnn-.-.An ^v^^-^oi-;^^ ., J *.~ J„£ 1.1. ~ 'ir\Ai\ /<-fi\A a 

pv/uuu-upciauwii uacva iu uciiiic UlC ( U^tu/ ( Vf± IJrLf 

(Transfer and Restore Parity and Traps) instruction 
would be: 

06/43,5/0,07/106,6/0,012/5165 

The following 7040/7044 instructions must be de- 
fined by a macro-operation: 

1. Input/Output instructions (except rds and wrs). 

2. Instructions which have part of the operation 
code in the low-order part of the address field and have 
a 12-bit operation code of — lxxx. 

3. Instructions requiring a one in bit position 14. The 
following coding illustrates the use of a macro- 
operation in defining the ctr (Control Select) 
instruction: 

CTR MACRO A,T,I 

VFD 015/57661,3/I,3/T,015/A 

ENDM CTR,NOCRS 

Where A is the address field, T is the tag field, and I is 
the interface. 

It is the responsibility of the programmer to ensure 
that only 7040/7044 instructions are used, since any 
7090/7094 instructions in the program will be assem- 
bled and will not be flagged. The following 7040/7044 
pseudo-operations differ to some extent from those in 
7090/7094 map: iff/if i, opd, call, save, return, file, 
label, and ttl. Also, there is no extern pseudo-opera- 
tion in 7090/7094 map. 
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Index 



abs pseudo-operation 34 

Absolute assemblies 6, 34 

Absolute-assembly pseudo-operations 6, 34 

Absolute expression 11 

Absolute origin 6, 9, 15 

Absolute symbols 9 

Adjective codes 54 



intumenf iirprai 



Alphameric subfield in vfd 20 

Assembly of 7040/7044 Programs on a 7090/7094 58 

Assembly-program language 5 

Asterisk (*) 

as an element 11 

in indirect addressing 7 

in relative addressing 12 

remarks card 8 

bcd character code 57 

bci pseudo-operation 19 

begin pseudo-operation 14 

bes pseudo-operation 16 

Binary-place part in fixed-point number 10 

Binary transfer card 34 

Bit count of vfd 20 

Blank common 14, 17, 27 

Blank location counter 14 

bool pseudo-operation 24 

Boolean expressions 12, 24 

Boolean pseudo-operations 5, 24 

Boolean variable code format 55 

bss pseudo-operation 15 

call pseudo-operation 37 

Calling macro-operations 43 

Calling sequence 37 

Comments field 7 

common pseudo-operation 17 

Compiler program 5 

Complex expression 11 

Conditional-assembl v in macro-operations , , 45 

Conditional-assembly pseudo-operations 5, 24 

Constants 9, 18 

contbl pseudo-operation 27 

Control section 26 

Control-section pseudo-operations 5, 26 

Created symbols in macro-operations 47 

"Current" location counter 6 

Data-generating pseudo-operations 5, 18 

Data item, decimal 9 

Debugging dictionary 16, 17, 22, 34 

dec pseudo-operation 19 

Decimal data item 9 

Decimal integer 9 

Decimal literals 9 

Defining macro-operations 41 

Defining symbols 8 

detail pseudo-operation 35 

Dimension 16, 22, 34 

Disk and Drum channel command format 55 

Disk file and drum file order format 55 

Disk file and drum file orders 52 

Double-precision literals 10, 17, 20 

dup pseudo-operation 21 

eject pseudo-operation 35 

Elements in expressions 11 

end pseudo-operation 33 

endm pseudo-operation 41, 43 



endq pseudo-operation 26 

entry pseudo-operation 27 

equ pseudo-operation 22 

Error checking 6 

Error returns 36 

etc pseudo-operation 33 

Evaluating expressions 11 

tt'ttt^-vt r\fQiiHn-Ar\Drotinn I i 
£jV£j11 |JOV uuv^ vp V* U HVA1 

Expansions 

of call 38 

in macro-operations 41, 43 

of save 38 

Exponent part 

fixed-point number 10 

floating-point number 10 

Expression** 

Expressions 

absolute 

Boolean 

complex 

elements of 

evaluation of 

operators in 

relocatable 

rules for forming 

symbols in 

terms in 

writing of 

Extended machine operations 50 

External file name 28 



fap-ibmap incompatibilities 56 

Fields 

comments 7 

instruction 6 

name 7 

operation 7 

sequence 8 

variable 7 

File-description pseudo-operations 5, 28 

File identification name 32 

File name 32 

external 28 

File options 

activity 29 

block sequence 30 

block size 29 

block-size check 31 

checkpoint 30 

checkpoint location 30 

check sum 30 

conversion 31 

disk/drum cylinder count 31 

disk/drum starting cylinder number 30 

disk/drum write-checking 31 

file close 30 

file density 30 

file mounting 29 

file usage 29 

Hypertape 31 

Hypertape reel switching 31 

label density 30 

mode 30 

nonstandard-label routine 31 

operator file list 29 
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pool-attachment 31 

reel handling 30 

file pseudo-operation 28 

File serial number 32 

File unit 

primary 28 

secondary 28 

File unit-assignment option 28 

Fixed-point number 10 

Floating-point number 9 

Format 

Boolean variable code 55 

disk and drum channel commands 55 

disk and drum file orders 55 

Hypertape orders 56 

Input/Output Commands 55 

operation code 54 

prefix operation code 55 

select instruction code 55 

type A instruction code 55 

type B instruction code 55 

type C instruction code 55 

type E instruction code 55 

unexpanded 7094 instruction code 56 

ful pseudo-operation 34 

goto pseudo-operation 25 

Hypertape order format 56 

Hypertape orders 52 

ibmap-fajp Incompatibilities 56 

iff pseudo-operation 24, 45 

ift pseudo-operation 24, 45 

Immediate symbols 9, 23 

index pseudo-operation 36 

Indirect addressing 7 

Input/output command format 55 

Instruction count of dup 21 

Instruction fields 6 

Instructions, type D 9, 23, 54 

Integer 

decimal 9 

octal 10 

irp pseudo-operation 47 

Irrelevant subfield 7 

Iteration count of dup 21 

keep pseudo-operation 16, 22, 34 

label pseudo-operation 31 

Languages 

assembly program 5 

compiler 5 

machine 5 

map 5 

lbl pseudo-operation 36 

lbool pseudo-operation 24 

ldir pseudo-operation 17 

Linkage Director 17, 38 

List-control pseudo-operations 6, 35 

list pseudo-operation 35 

lit pseudo-operation 20 

Literal Pool 9, 10, 17, 18, 20 

Literals 9 

alphameric 10 

decimal 9 

double-precision 10, 17 

octal 10 

litorg pseudo-operation 18 

Load address 6 

loc pseudo-operation 15 

Location-counter pseudo-operations 5, 14 

Location counter // 14, 17, 27 

Location counters 6, 14 

"current" 6 



Location symbols 8 

lorg pseudo-operation 18 

Machine-language program 5 

Machine operations 49 

extended 50 

select-type extended 50 

sense-type extended 50 

7090 49 

7094 51 

Macro-defining pseudo-operations 6, 41 

Macro-definition heading card 41 

Macro-definitions 41 

Macro-expansions 41, 43 

inserting instructions in 45 

of 7094 instructions 52 

Macro-instructions 41, 43 

delimiting parameters in 43 

in macro-definitions 44 

parameters in 44 

Macro-operation facility 6, 41 

Macro-operations 

conditional assembly in 45 

nested 46 

qualification in 46 

macro pseudo-operation 41 

Macro-related pseudo-operations 6, 47 

map bcd character code 57 

map language features 5 

map pseudo-operations 14 

max pseudo-operation 23 

min pseudo-operation 23 

Miscellaneous pseudo-operations 6, 33 
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